Gamehub
A little more you.

Sign in to save your favorites and make yourself at home.

For developers and publishers
Help & guides
Browse docs In-game economies
On this page
JAVASCRIPT SDKv0.3.38

Move value in your game economy.

Try it first

Inspect a server-owned test wallet operation#

You need A studio-authorized testnet economy and documented fee terms.

  1. Read the agent wallet identity and permitted operation.
  2. Record the intended transfer and its stable attempt key on your backend.
  3. Inspect the returned status and receipt before changing inventory.

Check your result The server can trace the authorized test operation to one wallet and receipt.

Use server-owned agent wallets and transfers on testnet. This is a separate flow from IAP and contest entry.

Keep agent operations on the backend#

agents.createWallet, agents.fund and transfers from NPC wallets require your secret test key. The old public Town demo secret is a fenced shared-demo exception; it does not make studio secrets safe in a client. This guide uses your server key instead.

Create and fund a test fixture#

Create both NPC wallets, then fund them as a separate test setup step. The fund helper is a sandbox treasury-to-agent operation, not a player faucet or production funding promise. Do not call it on every item purchase or retry.

Test fixture setupTypeScript
  1. await server.agents.createWallet({ agentId: 'npc_miner' });
  2. await server.agents.createWallet({ agentId: 'npc_shop' });
  3. await server.agents.fund({ agentId: 'npc_miner', amount: '0.50' });

Define transfer terms#

amount is a decimal USD string. Persist idempotencyKey once per transfer. feeBps is per-call pricing, unlike fixed IAP/pool fees; a positive fee requires an explicit feeSink. A zero-fee transfer needs no fee destination.

Reconcile the transfer#

Transfers use settling, settled and failed. Read transfers.get or transfers.wait for the same ID if still settling. Confirm the actual hash and amounts before updating your game’s ledger. IAP’s confirmed status is not the transfer status.

If it did not work#

A service signer is not permission to enable production custody. Keep unavailable or pending operations unfulfilled.

Try one variation Retry an already-recorded test operation using its original key. Explain why it must not authorize another transfer.

Continue with the next guide →