Composed Flows

SphereNet allows you to combine multiple transaction steps into a single API request. This enables complex flows like fiat on-ramp with transfer, or crypto on-ramp with currency exchange.

TradFi On-Ramp with Transfer

This example shows how to:

1. Receive USD via wire transfer (to Alice's account)
2. Transfer USD to another SphereNet account - requires signature

POST v1/transactions

curl https://api.sphere.net/v1/transactions \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: <Unique Idempotency Key>' \
  -d '{
    "amount": "1000.00",
    "customer": "cust_alice",
    "signature": "base64_encoded_signature",
    "source": {
      "paymentRail": "wire",
      "currency": "usd"
    },
    "intermaediateAccount": {
      "paymentRail": "spherenet",
      "account": "sphere1abc..."
    },
    "destination": {
      "paymentRail": "spherenet",
      "currency": "usd",
      "account": "sphere1xyz..."
    }
  }'

Response

{
  "ok": true,
  "object": "object",
  "statusCode": 200,
  "error": null,
  "message": "success",
  "data": {
    "id": "txn_123",
    "state": "processing",
    "customer": "cust_alice",
    "amount": "1000.00",
    "source": {
    "paymentRail": "wire",
    "currency": "usd"
    },
    "intermaediateAccount": {
      "paymentRail": "spherenet",
      "account": "sphere1abc..."
    },
    "destination": {
      "paymentRail": "spherenet",
      "currency": "usd",
      "account": "sphere1xyz..."
    },
    "networkData": {
      "signature": "2id3YC2jK9G5Wo2phDx4gJVAew8DcY5NAojnVuao8aCxBwKE7k4PoHiH1ViQX8KgB9CKBY2RcKF8PSbBqhqFQXXX",
      "slot": 430,
      "confirmations": 1,
      "commitment": "processed",
      "error": null
    },
    "sourceDepositInstructions": {
      "amount": "1000.00",
      "currency": "usd",
      "sepositMessage": "SPH7depositmessage"
    },
    "createdAt": "2024-01-20T19:39:14.316Z",
    "updatedAt": "2024-01-20T19:39:14.316Z"
  },
  "ts": "2024-08-22T16:15:42.707Z",
  "request": "request_cdde26b2c0534183a1aaba6baebaec1f"
}

Crypto On-Ramp with Exchange and Transfer

The example below shows how to:

1. Convert USDC from Solana to USD on SphereNet (to Alice's account)
2. Exchange USD to EUR (in Alice's account) - requires signature
3. Transfer EUR to another SphereNet account - requires signature

POST v1/transactions

curl https://api.sphere.net/v1/transactions \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: <Unique Idempotency Key>' \
  -d '{
    "amount": "1000.00",
    "customer": "cust_alice",
    "signature": "base64_encoded_signature",
    "source": {
      "paymentRail": "solana",
      "currency": "usdc",
      "fromAddress": "5KL6MAQ4i8ht4PR8uHE4CQrxRMXHNX9Jv9dUBgH7jj3j"
    },
    "intermaediateAccount": {
      "paymentRail": "spherenet",
      "account": "sphere1abc..."
    },
    "destination": {
      "paymentRail": "spherenet",
      "currency": "eur",
      "account": "sphere1xyz..."
    },
    "slippageTolerance": "0.01"
  }'

Response

{
  "ok": true,
  "object": "object",
  "statusCode": 200,
  "error": null,
  "message": "success",
  "data": {
    "id": "txn_123",
    "state": "processing",
    "customer": "cust_alice",
    "amount": "1000.00",
    "source": {
      "paymentRail": "solana",
      "currency": "usdc",
      "fromAddress": "5KL6MAQ4i8ht4PR8uHE4CQrxRMXHNX9Jv9dUBgH7jj3j"
    },
    "intermaediateAccount": {
      "paymentRail": "spherenet",
      "account": "sphere1abc..."
    },
    "destination": {
      "paymentRail": "spherenet",
      "currency": "eur",
      "account": "sphere1xyz..."
    },
    "networkData": {
      "signature": "2id3YC2jK9G5Wo2phDx4gJVAew8DcY5NAojnVuao8aCxBwKE7k4PoHiH1ViQX8KgB9CKBY2RcKF8PSbBqhqFQXXX",
      "slot": 430,
      "confirmations": 1,
      "commitment": "processed",
      "error": null
    },
    "sourceDepositInstructions": {
      "paymentRail": "solana",
      "amount": "1000.00",
      "currency": "usdc",
      "fromAddress": "5KL6MAQ4i8ht4PR8uHE4CQrxRMXHNX9Jv9dUBgH7jj3j",
      "toAddress": "8JFTv1FHAqEgupBxHmkzDwtRGtPojCQ4KyxE3HXGVN2i"
    },
    "exchangeRate": "0.92",
    "slippageTolerance": "0.01",
    "createdAt": "2024-01-20T19:39:14.316Z",
    "updatedAt": "2024-01-20T19:39:14.316Z"
  },
  "ts": "2024-08-22T16:15:42.707Z",
  "request": "request_cdde26b2c0534183a1aaba6baebaec1f"
}

Crypto Exchange and Off-Ramp to Fiat

This example shows how to:

1. Convert USDC from Solana to USD on SphereNet (to Alice's account)
2. Transfer USD to external bank account via wire - requires signature

POST v1/transactions

curl https://api.sphere.net/v1/transactions \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: <Unique Idempotency Key>' \
  -d '{
    "amount": "1000.00",
    "customer": "cust_alice",
    "signature": "base64_encoded_signature",
    "source": {
      "paymentRail": "solana",
      "currency": "usdc",
      "fromAddress": "5KL6MAQ4i8ht4PR8uHE4CQrxRMXHNX9Jv9dUBgH7jj3j"
    },
    "intermaediateAccount": {
      "paymentRail": "spherenet",
      "account": "sphere1abc..."
    },
    "destination": {
      "paymentRail": "wire",
      "currency": "usd",
      "bankAccountId": "ext_123"
    }
  }'

Response

{
  "ok": true,
  "object": "object",
  "statusCode": 200,
  "error": null,
  "message": "success",
  "data": {
    "id": "txn_123",
    "state": "awaitingFunds",
    "customer": "cust_alice",
    "amount": "1000.00",
    "source": {
      "paymentRail": "solana",
      "currency": "usdc",
      "fromAddress": "5KL6MAQ4i8ht4PR8uHE4CQrxRMXHNX9Jv9dUBgH7jj3j"
    },
    "intermaediateAccount": {
      "paymentRail": "spherenet",
      "account": "sphere1abc..."
    },
    "destination": {
      "paymentRail": "wire",
      "currency": "usd",
      "bankAccountId": "ext_123"
    },
    "sourceDepositInstructions": {
      "paymentRail": "solana",
      "amount": "1000.00",
      "currency": "usdc",
      "fromAddress": "5KL6MAQ4i8ht4PR8uHE4CQrxRMXHNX9Jv9dUBgH7jj3j",
      "toAddress": "8JFTv1FHAqEgupBxHmkzDwtRGtPojCQ4KyxE3HXGVN2i"
    },
    "createdAt": "2024-01-20T19:39:14.316Z",
    "updatedAt": "2024-01-20T19:39:14.316Z"
  },
  "ts": "2024-08-22T16:15:42.707Z",
  "request": "request_cdde26b2c0534183a1aaba6baebaec1f"
}