Prepare Transactions

curl -X POST /api/v1/transfers/42/prepare \
  -H "x-api-key: mh_live_abc123..." \
  -H "Idempotency-Key: $(uuidgen)"

{
  "transfer": { "id": 42, "status": "awaiting_signature" },
  "preparedTxs": {
    "keeperFundingTx": "AQAAAAAAAA...",
    "routeInitTxs": [{ "base64": "AQAAAAAAAA..." }],
    "orchestratorInitTx": null,
    "sessionInitTxs": ["AQAAAAAAAA...", "AQAAAAAAAA..."],
    "recentBlockhash": "BpFi8bTNRuLbUnrq7q1N1M...",
    "lastValidBlockHeight": 289043200,
    "resume": {
      "routeAlreadyDeployed": false,
      "existingHopCount": 0,
      "totalHops": 7,
      "orchestratorAlreadyInitialized": true,
      "completedStepIndices": [],
      "totalSteps": 7,
      "keeperAlreadyFunded": false,
      "nothingToDo": false
    }
  }
}

POST

api

transfers

{transferId}

prepare

curl -X POST /api/v1/transfers/42/prepare \
  -H "x-api-key: mh_live_abc123..." \
  -H "Idempotency-Key: $(uuidgen)"

{
  "transfer": { "id": 42, "status": "awaiting_signature" },
  "preparedTxs": {
    "keeperFundingTx": "AQAAAAAAAA...",
    "routeInitTxs": [{ "base64": "AQAAAAAAAA..." }],
    "orchestratorInitTx": null,
    "sessionInitTxs": ["AQAAAAAAAA...", "AQAAAAAAAA..."],
    "recentBlockhash": "BpFi8bTNRuLbUnrq7q1N1M...",
    "lastValidBlockHeight": 289043200,
    "resume": {
      "routeAlreadyDeployed": false,
      "existingHopCount": 0,
      "totalHops": 7,
      "orchestratorAlreadyInitialized": true,
      "completedStepIndices": [],
      "totalSteps": 7,
      "keeperAlreadyFunded": false,
      "nothingToDo": false
    }
  }
}

Probes on-chain state and returns the full bundle of unsigned Solana transactions that sourceOwner must sign and broadcast to deploy the transfer. This endpoint is resumable — re-call it after a partial broadcast to get a fresh blockhash and drop any groups already confirmed on-chain (null fields are already on chain, skip them).

On compliance-enabled networks (mainnet) the bundle includes a flat 0.002 SOL screening fee transfer that runs at deploy. Ensure the sourceOwner wallet holds enough SOL to cover route amount + protocol fees + account rent + keeper funding + the screening fee before signing — the fee is not part of /estimate. It is a refundable anti-abuse deposit: a clean (verified) route gets it back, a flagged route forfeits it. Either way the wallet must hold it at deploy time. See Compliance & screening.

Path parameters

transferId

integer

required

The internal transfer ID.

Response

transfer

object

Current transfer state.

preparedTxs

object

Bundle of unsigned transactions to sign and broadcast.

Show preparedTxs fields

preparedTxs.keeperFundingTx

string | null

Broadcast FIRST. Base64 VersionedTransaction that transfers SOL to the assigned keeper. null if keeper is already funded.

preparedTxs.routeInitTxs

array

Array of { base64 } VersionedTransactions to initialize the on-chain route. Empty if route is already deployed.

preparedTxs.orchestratorInitTx

string | null

Base64 legacy Transaction to initialize the orchestrator config PDA. null if already initialized.

preparedTxs.sessionInitTxs

array

Array of base64 VersionedTransactions to initialize step state PDAs. Entries for already-initialized steps are omitted.

preparedTxs.recentBlockhash

string

Blockhash used to build these transactions. Sign and broadcast before this expires (~60s).

preparedTxs.lastValidBlockHeight

integer

Last block height at which these transactions are valid.

preparedTxs.resume

object

Snapshot of on-chain state used to build the bundle.

Show resume fields

resume.routeAlreadyDeployed

boolean

resume.existingHopCount

integer

resume.totalHops

integer

resume.orchestratorAlreadyInitialized

boolean

resume.completedStepIndices

array

Indices of step PDAs already on-chain.

resume.totalSteps

integer

resume.keeperAlreadyFunded

boolean

resume.nothingToDo

boolean

true if all groups are null/empty — no signing needed.

curl -X POST /api/v1/transfers/42/prepare \
  -H "x-api-key: mh_live_abc123..." \
  -H "Idempotency-Key: $(uuidgen)"

{
  "transfer": { "id": 42, "status": "awaiting_signature" },
  "preparedTxs": {
    "keeperFundingTx": "AQAAAAAAAA...",
    "routeInitTxs": [{ "base64": "AQAAAAAAAA..." }],
    "orchestratorInitTx": null,
    "sessionInitTxs": ["AQAAAAAAAA...", "AQAAAAAAAA..."],
    "recentBlockhash": "BpFi8bTNRuLbUnrq7q1N1M...",
    "lastValidBlockHeight": 289043200,
    "resume": {
      "routeAlreadyDeployed": false,
      "existingHopCount": 0,
      "totalHops": 7,
      "orchestratorAlreadyInitialized": true,
      "completedStepIndices": [],
      "totalSteps": 7,
      "keeperAlreadyFunded": false,
      "nothingToDo": false
    }
  }
}

Create Transfer Confirm Broadcast

API documentation

Transfers

Webhooks

Integration

Path parameters

Response

​Path parameters

​Response

Path parameters

Response