SocketFi Transactions: How Blockchain Actions Work

┌─────────────────────────────┐
│         Application         │  Defines intent — what should happen
└──────────────┬──────────────┘
               │
┌──────────────▼──────────────┐
│         SocketFi SDK        │  Validates, constructs, and routes the request
└──────────────┬──────────────┘
               │
┌──────────────▼──────────────┐
│      Transaction Approval   │  User reviews and approves the action
└──────────────┬──────────────┘
               │
┌──────────────▼──────────────┐
│         Smart Wallet        │  Authorizes, enforces policies, validates nonces
└──────────────┬──────────────┘
               │
┌──────────────▼──────────────┐
│       Soroban Network       │  Executes the contract call on-chain
└──────────────┬──────────────┘
               │
┌──────────────▼──────────────┐
│       Execution Result      │  Success with hash, or failure with reason
└─────────────────────────────┘

// Successful execution
{
  success: true,
  transactionHash: "abc123..."
}

// Failed execution
{
  success: false
}

const result = await socketfi.requestTransaction({
  contractId: "CBXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  method: "transfer",
  args: [recipientAddress, amount],
});

if (result.success) {
  console.log("Transfer complete:", result.transactionHash);
} else {
  console.warn("Transfer was not completed");
}