Backend wallet with Rest API

Use a backend wallet to transfer an asset using Rest API.

You can also request Openfort's REST API directly to use backend wallets. When requesting the REST API directly, you must set certain headers on your requests.

Get your API Keys

Open your project in the Openfort Dashboard and grab your secret key from the project settings.

All API requests must be authenticated using your secret key. Include it in the Authorization header using Basic auth.

Terminal

# Export your secret key as an environment variable
export YOUR_SECRET_KEY=sk_test_...
# Test the API connection
curl https://api.openfort.xyz/v1/tokens \
  -u "$YOUR_SECRET_KEY:"

Create a backend wallet

Backend wallet (dac) can be used for escrow, minting, and transferring assets. Create a new custodial Backend wallet using the API.

The response will include the backend wallet ID (starts with dac_) and its blockchain address.

Terminal

curl https://api.openfort.xyz/v1/settings/developer_accounts \
  -u "$YOUR_SECRET_KEY:" \
  -d name="Transfer Account"

Add a contract to Openfort

Add your token contract to Openfort. This example uses a simple ERC-20 contract with transfer functionality.

Save the returned contract ID (starts with con_) for the next step.

Terminal

curl https://api.openfort.xyz/v1/contracts \
  -u "$YOUR_SECRET_KEY:" \
  -d chainId=80002 \
  -d address="0x2522F4Fc9aF2E1954a3D13f7a5B2683A00a4543A" \
  -d abi=[
      {
        "inputs": [
          {
            "internalType": "address",
            "name": "to",
            "type": "address"
          },
          {
            "internalType": "uint256",
            "name": "amount",
            "type": "uint256"
          }
        ],
        "name": "transfer",
        "outputs": [
          {
            "internalType": "bool",
            "name": "",
            "type": "bool"
          }
        ],
        "stateMutability": "nonpayable",
        "type": "function"
      }
    ] \
  -d name="Example Token"

Create a Transfer Transaction

Create a transaction intent to transfer tokens using your backend wallet. Replace:

dac_... with your Backend wallet ID
con_... with your contract ID
pla_... with the recipient's player ID
The amount with your desired transfer amount in wei (the example shows 1 token with 18 decimals)

Setting optimistic=true means the response will be returned after simulation but before on-chain confirmation.

Terminal

curl https://api.openfort.xyz/v1/transaction_intents \
  -u "$YOUR_SECRET_KEY:" \
  -d chainId=80002 \
  -d 'account=dac_...' \
  -d optimistic=true \
  -d 'interactions[0][contract]=con_....' \
  -d 'interactions[0][functionName]=transfer' \
  -d 'interactions[0][functionArgs][0]=pla_...' \
  -d 'interactions[0][functionArgs][1]=1000000000000000000'

Check Transaction Status

You can check the status of your transaction using the transaction intent ID returned in the previous step.

The response will include the transaction hash and status once the transaction is processed.

Terminal

curl https://api.openfort.xyz/v1/transaction_intents/tin_... \
  -u "$YOUR_SECRET_KEY:"