gdex-transfers git:20261019.6b44a34A

Immutable. This exact content never changes and is served at /api/v1/blob/00191497281384d9.

---
name: gdex-transfers
description: Native and ERC20/SPL token transfers via GDEX managed custody — send assets to any recipient on supported chains
---

# GDEX: Transfers

Send native assets (ETH, SOL, SUI, BNB, …) or ERC20 / SPL tokens from a
managed-custody wallet to any recipient.

## When to Use

- Withdrawing native assets to an external wallet
- Sending ERC20 / SPL tokens to a recipient
- Paying out winnings, rewards, or peer-to-peer transfers

## Prerequisites

- `@gemachdao/gdex-skill` installed
- Authenticated via managed-custody sign-in — see **gdex-authentication**
- Session keypair (`sessionPrivateKey` + `sessionKey`) from sign-in
- Pre-built `computedData` payload (encrypted via the standard AES-256-CBC
  managed-custody contract). Caller is responsible for ABI-encoding the
  transfer parameters and signing with the session key — schema is
  documented in `src/api/services/ServiceMain.ts` of the backend.

## Backend Endpoints

| Method | Path | Purpose |
|--------|------|---------|
| `POST` | `/v1/transfer` | Native token transfer |
| `POST` | `/v1/transfer_token` | ERC20 / SPL token transfer |

Both endpoints accept:
```json
{ "computedData": "<hex>", "chainId": 8453 }
```

## SDK Usage

```typescript
import { GdexSkill } from '@gemachdao/gdex-skill';

const skill = new GdexSkill();
skill.loginWithApiKey(process.env.GDEX_API_KEY!);

// Native ETH transfer (caller pre-builds computedData)
const result = await skill.transferNative({
  computedData,           // hex-encoded encrypted payload
  chainId: 8453,
});

// ERC20 / SPL transfer
const result2 = await skill.transferToken({
  computedData,
  chainId: 622112261,     // Solana SPL
});

// Or let the SDK build and sign the payload. `amount` is raw base units
// (native decimals for transferNative, the token's decimals for transferToken)
// and chainId is required.
const result3 = await skill.transferToken({
  recipient: '0xRecipient',
  tokenAddress: '0xToken',
  amount: '1000000',      // 1 USDC at 6 decimals
  chainId: 8453,
  managed: { apiKey, walletAddress, sessionPrivateKey, userId },
});
```

## Response

Typically:
```json
{ "requestId": "...", "status": "pending", "createdAt": 1717000000 }
```
Poll status via `GET /v1/trade-status/:requestId` (or `skill.getManagedTradeStatus(requestId)`).

## Notes

- Both endpoints follow the standard managed-custody encrypted-payload pattern.
- For Solana SPL transfers, the first transfer to a recipient may incur an
  Associated Token Account (ATA) creation fee (~0.002 SOL).
- Chain id semantics match the rest of the SDK — Solana uses `622112261`,
  Sui uses `1313131213`.