Types Reference

enum WhitelistMode {
  None = 0,
  Merkle = 1,
  Bloom = 2,
  Domain = 3,
}

enum PrivacyLevel {
  Public = 0,
  Confidential = 1,
}

enum EscrowState {
  Created = 0,
  Funded = 1,
  Delivered = 2,
  Disputed = 3,
  Released = 4,
  Refunded = 5,
  Cancelled = 6,
}

enum X402ErrorCode {
  PaymentRequired = 402,
  PaymentMismatch = 409,
  PaymentExpired = 410,
  InsufficientFunds = "402.1",
  LimitExceeded = "402.2",
  NotWhitelisted = "402.3",
}

enum ProofType {
  PubkeyValidity = 0,
  Withdraw = 1,
  ZeroBalance = 2,
  Transfer = 3,
}

enum AdminActionType {
  SetFeeRate = 0,
  SetPaused = 1,
  EmergencyWithdraw = 2,
  TransferAdmin = 3,
}

type WhitelistData = NoWhitelistData | MerkleWhitelistData | BloomWhitelistData | DomainWhitelistData;

interface NoWhitelistData { mode: WhitelistMode.None }
interface MerkleWhitelistData { mode: WhitelistMode.Merkle; root: Uint8Array }
interface BloomWhitelistData { mode: WhitelistMode.Bloom; bits: Uint8Array; hashCount: number }
interface DomainWhitelistData { mode: WhitelistMode.Domain; allowedPrefixes: Uint8Array[] }

interface MerkleProof { path: Uint8Array[] }

type PrivacyConfig = PublicPrivacy | ConfidentialPrivacy;

interface PublicPrivacy { level: PrivacyLevel.Public }
interface ConfidentialPrivacy { level: PrivacyLevel.Confidential; auditor?: PublicKey }

interface SpendingEntry {
  amount: BN;
  timestamp: number;
}

interface SpendingStats {
  totalSpent24h: BN;
  transactionCount: number;
  remainingAllowance: BN;
  oldestEntryExpiry: number;
}

interface EscrowParams {
  useEscrow: boolean;
  arbiter?: PublicKey;
  autoReleaseDelay?: number;
  deliveryTimeout?: number;
}

interface Capability {
  type: string;
  capType?: string;
  metadata: string;
}

interface ReputationScore {
  score: number;        // 0-10000
  isReliable: boolean;  // score >= 7000
  components: {
    successRate: number;
    resolutionRate: number;
    disputeRate: number;
  };
}

interface ReputationSnapshot {
  timestamp: number;
  score: number;
  totalTransactions: BN;
  successRate: number;
}

interface X402Header {
  raw: string;
  request: X402PaymentRequest;
}

interface PaymentReceipt {
  signature: string;
  amount: BN;
  recipient: PublicKey;
  memoHash: Uint8Array;
  blockTime: number;
  slot: number;
  usedEscrow: boolean;
  escrowAddress?: PublicKey;
}

interface BlinkAction {
  label: string;
  type: string;
  href?: string;
  parameters: BlinkParameter[];
}

interface BlinkParameter {
  name: string;
  type: "text" | "number" | "signature" | "pubkey";
  required: boolean;
  description: string;
  label?: string;
}

interface TransactionResult {
  signature: string;
  confirmed: boolean;
  blockTime?: number;
  slot: number;
}

interface SimulationResult {
  success: boolean;
  logs: string[];
  unitsConsumed?: number;
  error?: string;
}

interface PaymentOptions {
  skipPreflight?: boolean;
  commitment?: Commitment;
  maxRetries?: number;
}

interface ConfidentialAccountConfig {
  elgamalPubkey: Uint8Array;
  aeKey: Uint8Array;
  maxPendingCredits?: number;
}