Transactions on Continuum

Request Body:

{
  transactionId: string;       // Required. Unique transaction identifier
  fromEntityId: string;        // Required. Source entity ID
  fromAccountId: string;       // Required. Source account ID (must be NON_CUSTODIAL_WALLET type)
  toEntityId: string;          // Required. Destination entity ID
  toAccountId: string;         // Required. Destination account ID (blockchain account)
  exactAmountIn?: number;      // Required if exactAmountOut not provided. Amount to send
  exactAmountOut?: number;     // Required if exactAmountIn not provided. Amount to receive
}

{
  executionId: string; // Execution ID (starts with "cexec-" prefix for crypto)
  quote: {
    inAmount: {
      amount: number; // Input amount
      currency: string; // Input currency (e.g., "USDC")
    }
    outAmount: {
      amount: number; // Output amount
      currency: string; // Output currency
    }
    exchangeRate: {
      rate: number; // Exchange rate (1 for direct transfers)
      conversion: string; // Human-readable conversion string
    }
    fees: {
      partnerFees: {
        amount: number; // Partner fee amount
        currency: string; // Fee currency
      }
      zynkFees: {
        amount: number; // Zynk platform fee
        currency: string; // Fee currency
      }
      totalFees: {
        amount: number; // Total fees
        currency: string; // Fee currency
      }
    }
  }
  payloadToSign: string; // ⭐ NEW: Unsigned transaction payload to be signed
  validUntil: string; // ISO 8601 timestamp when quote expires
  message: string; // Status message
}

curl -X POST /api/v1/transformer/transaction/simulate \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "transactionId": "txn_crypto_001",
    "fromEntityId": "entity_123",
    "fromAccountId": "account_456",
    "toEntityId": "entity_789",
    "toAccountId": "account_012",
    "exactAmountIn": 10.5
  }'

{
  "executionId": "cexec-abc123def456",
  "quote": {
    "inAmount": {
      "amount": 10.5,
      "currency": "USDC"
    },
    "outAmount": {
      "amount": 10.5,
      "currency": "USDC"
    },
    "exchangeRate": {
      "rate": 1,
      "conversion": "1 USDC = 1 USDC"
    },
    "fees": {
      "partnerFees": {
        "amount": 0,
        "currency": "USDC"
      },
      "zynkFees": {
        "amount": 0,
        "currency": "USDC"
      },
      "totalFees": {
        "amount": 0,
        "currency": "USDC"
      }
    }
  },
  "payloadToSign": "{\"type\":\"ACTIVITY_TYPE_SIGN_TRANSACTION_V2\",\"organizationId\":\"org_xyz\",\"timestampMs\":\"1698765432000\",\"parameters\":{...}}",
  "validUntil": "2024-10-27T11:30:00.000Z",
  "message": "Transaction simulation successful"
}

{
  executionId: string; // Required. Execution ID from simulate (starts with "cexec-")
  payloadSignature: string; // ⭐ Required. Signed transaction payload (X-Stamp header value)
  transferAcknowledgement: string; // Required for fiat. Transfer confirmation
  signatureType: string; // ⭐ Required. Either "WebAuthn" or "ApiKey"
}

{
  executionId: string; // Execution ID
  message: string; // Success message
}

curl -X POST /api/v1/transformer/transaction/transfer \
  -H "Authorization: Bearer -token-" \
  -H "Content-Type: application/json" \
  -d '{
    "executionId": "cexec-abc123def456",
    "payloadSignature": "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9...",
    "signatureType": "WebAuthn"
  }'
  

{
  "executionId": "cexec-abc123def456",
  "message": "Wallet execution completed successfully"
}

1. Simulate Transaction
   ↓
   POST /api/v1/transformer/transaction/simulate
   → Returns: executionId + payloadToSign

2. Sign Payload (Client-Side)
   ↓
   User signs the payloadToSign using their passkey
   → Generates: payloadSignature

3. Execute Transaction
   ↓
   POST /api/v1/transformer/transaction/transfer
   {
     executionId,
     payloadSignature,
     signatureType: "WebAuthn"
   }
   → Returns: Success confirmation

4. Transaction Broadcast
   ↓
   Signed transaction is broadcast to blockchain
   → Transaction hash recorded in execution