Transfers

Transfers are the most common CAW operation. A runtime submits a transfer with an active pact or delegation, CAW evaluates it against the policy engine, and the result is either allowed, denied, or paused for owner approval.

Submit a transfer

CLI
Python SDK
TypeScript SDK

caw tx transfer \
  --pact-id <PACT_ID> \
  --dst-address 0xRecipient... \
  --token-id SETH_USDC \
  --amount 50 \
  --chain-id SETH \
  --request-id invoice-001

from cobo_agentic_wallet import WalletAPIClient

agent_client = WalletAPIClient(base_url=API_URL, api_key=AGENT_API_KEY)

result = await agent_client.transfer_tokens(
    wallet_uuid=WALLET_UUID,
    chain_id="SETH",
    dst_addr="0xRecipient...",
    token_id="SETH_USDC",
    amount="50",
    request_id="invoice-001",
)
print(result["status"])

const result = (await txApi.transferTokens(walletUuid, {
  chain_id: 'SETH',
  dst_addr: '0xRecipient...',
  token_id: 'SETH_USDC',
  amount: '50',
  request_id: 'invoice-001',
})).data.result;
console.log(result.status);

Response model

Field	Description
`status`	`submitted`, `pending`, or `pending_approval`
`cobo_transaction_id`	Transaction identifier if the request reached execution
`transaction_hash`	On-chain hash after broadcast/confirmation
`request_id`	Your idempotency key
`pending_operation_id`	Present only when the operation needs owner approval

Idempotency

Use a stable request_id tied to your business action. If the runtime retries the same transfer after a timeout or process restart, CAW returns the original operation instead of creating a duplicate.

result = await agent_client.transfer_tokens(
    wallet_uuid=WALLET_UUID,
    chain_id="SETH",
    dst_addr="0xRecipient...",
    token_id="SETH_USDC",
    amount="50",
    request_id="invoice-2026-001",
)

Pending approval

If the transfer is above an owner review threshold, CAW returns status="pending_approval" instead of failing. Your runtime should pause that task and resume after the owner acts in the Cobo Agentic Wallet app.

Python SDK
TypeScript SDK

result = await agent_client.transfer_tokens(
    wallet_uuid=WALLET_UUID,
    chain_id="SETH",
    dst_addr="0xRecipient...",
    token_id="SETH_USDC",
    amount="800",
)

if result.get("status") == "pending_approval":
    pending_id = result["pending_operation_id"]
    print(f"Waiting for owner approval: {pending_id}")

const result = (await txApi.transferTokens(walletUuid, {
  chain_id: 'SETH',
  dst_addr: '0xRecipient...',
  token_id: 'SETH_USDC',
  amount: '800',
})).data.result;

if (result.status === 'pending_approval') {
  console.log(result.pending_operation_id);
}

If the operation is outside policy entirely, CAW returns a denial instead. See Handle Policy Denial.

Before you submit

For production flows, estimate fees first and keep tracking tied to request_id.

Estimate fees: Contract Calls
Track results: Transaction Tracking

Start here

Frameworks & MCP

Concepts

How-to

Submit a transfer

Response model

Idempotency

Pending approval

Before you submit

​Submit a transfer

​Response model

​Idempotency

​Pending approval

​Before you submit

Submit a transfer

Response model

Idempotency

Pending approval

Before you submit