Wallet (sdk.wallet)

async getInfo(userId: string): Promise<WalletInfo>

interface WalletInfo {
  userId: string;
  publicKey: string; // Stellar public key starting with 'G...'
  network: 'testnet' | 'mainnet';
  provider: 'crypto' | 'airtm';
  status: 'ACTIVE' | 'INACTIVE';
  createdAt: string; // ISO-8601 string
}

import { OfferHubSDK } from '@offerhub/sdk';

const sdk = new OfferHubSDK({
  apiUrl: process.env.OFFERHUB_API_URL!,
  apiKey: process.env.OFFERHUB_API_KEY!,
});

const walletInfo = await sdk.wallet.getInfo('usr_abc123');
console.log('Stellar Public Key:', walletInfo.publicKey);
console.log('Network:', walletInfo.network);
console.log('Status:', walletInfo.status);

async getDepositAddress(userId: string): Promise<DepositAddress>

interface DepositAddress {
  provider: 'crypto' | 'airtm';
  method: 'stellar_address' | 'airtm_payin';
  address: string; // Stellar G... public key or payment identifier
  asset: {
    code: string; // "USDC"
    issuer: string; // Stellar issuer public key (Circle)
  };
  network: 'testnet' | 'mainnet';
  memo?: string | null;
  instructions: string;
}

const deposit = await sdk.wallet.getDepositAddress('usr_abc123');

console.log(`Deposit ${deposit.asset.code} to: ${deposit.address}`);
console.log(`Issuer: ${deposit.asset.issuer}`);
console.log(`Network: ${deposit.network}`);
console.log(`Instructions: ${deposit.instructions}`);

async getTransactions(
  userId: string,
  params?: WalletTransactionsParams
): Promise<PaginatedWalletTransactions>

interface WalletTransaction {
  id: string; // Internal transaction ID e.g. "tx_01HXYZ..."
  hash: string; // Stellar on-chain transaction hash
  type: 'DEPOSIT' | 'WITHDRAWAL' | 'ESCROW_LOCK' | 'ESCROW_RELEASE';
  amount: string; // Decimal string e.g. "100.00"
  asset: string; // "USDC"
  from: string; // Source Stellar address
  to: string; // Destination Stellar address
  status: 'SUCCESS' | 'PENDING' | 'FAILED';
  createdAt: string; // ISO-8601 timestamp
}

interface PaginatedWalletTransactions {
  items: WalletTransaction[];
  pagination: {
    hasMore: boolean;
    nextCursor?: string | null;
    total?: number;
  };
}

const history = await sdk.wallet.getTransactions('usr_abc123', {
  limit: 10,
  order: 'desc',
});

console.log(`Retrieved ${history.items.length} transactions:`);
for (const tx of history.items) {
  console.log(`- [${tx.type}] ${tx.amount} ${tx.asset} (Hash: ${tx.hash}) - ${tx.status}`);
}

if (history.pagination.hasMore && history.pagination.nextCursor) {
  console.log('Next cursor:', history.pagination.nextCursor);
}