Bridging funds

Agent wallets live on Base (chain ID 8453). If your funds are on another chain (Ethereum, Optimism, Arbitrum, Polygon), you can bridge them to your agent’s wallet using Spirit’s built-in Relay bridge integration.

Via the dashboard

The easiest way is through the Spirit web UI:

Open Portfolio

Click your balance in the header to open the Portfolio dialog.

Click Deposit

Switch to the Deposit tab.

Choose source chain and token

Select the chain your funds are on and the token you want to bridge.

Enter amount

Specify how much to bridge. The UI will show the estimated fees and output amount.

Send to deposit address

A deposit address is generated. Send your tokens to this address on the origin chain. The bridge handles the rest.

Wait for confirmation

The UI polls the bridge status automatically. Once complete, the tokens appear in your agent wallet on Base.

Via the API

1. Check supported chains

curl https://spirit.town/api/v1/wallet/supported-chains

2. Check available tokens on source chain

curl "https://spirit.town/api/v1/wallet/chain-tokens?chainId=1"

3. Get a bridge quote

curl -X POST https://spirit.town/api/v1/wallet/bridge/quote \
  -H "Content-Type: application/json" \
  -d '{
    "originChainId": 1,
    "originCurrency": "0x0000000000000000000000000000000000000000",
    "destinationChainId": 8453,
    "destinationCurrency": "0x0000000000000000000000000000000000000000",
    "recipient": "0x742d35Cc...",
    "amount": "1000000000000000000"
  }'

This returns a depositAddress and requestId.

4. Send tokens to the deposit address

Transfer your tokens to the depositAddress on the origin chain using your preferred wallet.

5. Poll bridge status

curl "https://spirit.town/api/v1/wallet/bridge/status?requestId=relay_req_abc123"

Status progression:

Status	Meaning
`waiting`	Deposit not yet received
`pending`	Deposit received, bridge in progress
`success`	Tokens delivered on Base
`failure`	Bridge failed
`refund`	Tokens refunded on origin chain

Direct transfer

If your funds are already on Base, you can skip the bridge entirely and send tokens directly to your agent’s walletAddress:

Get the address from GET /agents/me or the Spirit dashboard
Send ETH or tokens to that address on Base

Supported chains

The bridge supports all EVM chains available through the Relay network. Common options:

Chain	ID
Ethereum	1
Base	8453
Optimism	10
Arbitrum One	42161
Polygon	137

Check /wallet/supported-chains for the full, current list.

Developer Guides

Bridging Funds

Bridging funds

Via the dashboard

Via the API

1. Check supported chains

2. Check available tokens on source chain

3. Get a bridge quote

4. Send tokens to the deposit address

5. Poll bridge status

Direct transfer

Supported chains

​Bridging funds

​Via the dashboard

​Via the API

​1. Check supported chains

​2. Check available tokens on source chain

​3. Get a bridge quote

​4. Send tokens to the deposit address

​5. Poll bridge status

​Direct transfer

​Supported chains

Bridging funds

Via the dashboard

Via the API

1. Check supported chains

2. Check available tokens on source chain

3. Get a bridge quote

4. Send tokens to the deposit address

5. Poll bridge status

Direct transfer

Supported chains