veilioexchange 0.1.0 → 0.3.0

package/dist/cjs/solana/escrow.d.ts

@@ -0,0 +1,193 @@
+/**
+ * VEILIO Solana Services Escrow Client & Program Interface
+ *
+ * Implements client-side PDA derivation, Anchor instruction serialization,
+ * account deserialization, fee calculations, and transaction verification
+ * for the dedicated Solana Devnet VeilServiceEscrow program.
+ */
+import { type SolanaCompiledInstruction } from './registry.js';
+export declare const ESCROW_SEED: Buffer<ArrayBuffer>;
+export declare const VAULT_SEED: Buffer<ArrayBuffer>;
+export declare const MAX_DELIVERABLE_REF_LEN = 200;
+export declare const MAX_FEE_BPS = 500;
+/** Global platform config PDA seed: [b"escrow_config"] (EscrowConfig account). */
+export declare const ESCROW_CONFIG_SEED: Buffer<ArrayBuffer>;
+/** 8 (discriminator) + 32 admin + 32 reviewer + 32 fee_recipient + 2 fee_basis_points + 1 bump */
+export declare const ESCROW_CONFIG_ACCOUNT_SIZE = 107;
+export declare const DEFAULT_SOLANA_SERVICE_ESCROW_PROGRAM_ID = "5Vj4y8BT74PDe5VwLuDp9agTR5ak4vtZdwxnBfRW3R8s";
+export type SolanaServiceEscrowStatus = 'None' | 'Funded' | 'Delivered' | 'Released' | 'Refunded' | 'Disputed';
+export declare const SOLANA_SERVICE_ESCROW_STATUS_MAP: Record<number, SolanaServiceEscrowStatus>;
+export interface DecodedSolanaEscrowOrder {
+    buyer: string;
+    seller: string;
+    reviewer: string;
+    feeRecipient: string;
+    orderIdHex: string;
+    orderIdBytes: Uint8Array;
+    amountLamports: bigint;
+    amountSol: string;
+    feeBasisPoints: number;
+    deadline: number;
+    status: SolanaServiceEscrowStatus;
+    createdAt: number;
+    settledAt: number;
+    deliverableReference: string;
+    bump: number;
+    vaultBump: number;
+}
+/**
+ * Derives the EscrowOrder account PDA: [b"service_escrow", order_id]
+ */
+export declare function findEscrowOrderPda(orderId: string | Uint8Array, programId?: string): {
+    pda: string;
+    bump: number;
+};
+/**
+ * Derives the Vault account PDA holding SOL lamports: [b"service_vault", order_id]
+ */
+export declare function findVaultPda(orderId: string | Uint8Array, programId?: string): {
+    pda: string;
+    bump: number;
+};
+/**
+ * Derives the global EscrowConfig PDA: [b"escrow_config"]. Holds the platform reviewer, fee
+ * recipient and fee rate that the upgraded program snapshots into every new order.
+ */
+export declare function findEscrowConfigPda(programId?: string): {
+    pda: string;
+    bump: number;
+};
+export interface DecodedSolanaEscrowConfig {
+    admin: string;
+    reviewer: string;
+    feeRecipient: string;
+    feeBasisPoints: number;
+    bump: number;
+}
+/** Decodes the EscrowConfig account (admin, reviewer, fee_recipient, fee_basis_points u16, bump). */
+export declare function decodeEscrowConfigAccount(buffer: Uint8Array | Buffer): DecodedSolanaEscrowConfig;
+/**
+ * Encodes initialize_config(reviewer, fee_recipient, fee_basis_points). Only the program's
+ * upgrade authority (`admin`) can call it, once.
+ * accounts: [config (mut, pda), admin (signer, mut), program, program_data, system_program]
+ */
+export declare function createInitializeEscrowConfigInstruction(params: {
+    programId?: string;
+    admin: string;
+    reviewer: string;
+    feeRecipient: string;
+    feeBasisPoints: number;
+}): SolanaCompiledInstruction;
+/**
+ * Encodes update_config(reviewer, fee_recipient, fee_basis_points, new_admin). Signed by the
+ * current config admin; `newAdmin` defaults to `admin` (no hand-over).
+ * accounts: [config (mut, pda), admin (signer)]
+ */
+export declare function createUpdateEscrowConfigInstruction(params: {
+    programId?: string;
+    admin: string;
+    reviewer: string;
+    feeRecipient: string;
+    feeBasisPoints: number;
+    newAdmin?: string;
+}): SolanaCompiledInstruction;
+/**
+ * Encodes the deposit instruction:
+ * accounts: [escrow_order (mut, pda), vault (mut, pda), buyer (signer, mut), system_program, config]
+ *
+ * The trailing read-only `config` PDA is required by the upgraded program (which takes the
+ * reviewer / fee recipient / fee rate from it and ignores the `reviewer` / `feeRecipient`
+ * args). The pre-upgrade program ignores it as an Anchor remaining account.
+ */
+export declare function createDepositServiceOrderInstruction(params: {
+    programId?: string;
+    buyer: string;
+    seller: string;
+    reviewer: string;
+    feeRecipient: string;
+    orderId: string | Uint8Array;
+    amountLamports: bigint | number;
+    deadline: number;
+}): SolanaCompiledInstruction;
+/**
+ * Encodes the submit_delivery instruction:
+ * accounts: [escrow_order (mut), seller (signer)]
+ */
+export declare function createSubmitDeliveryInstruction(params: {
+    programId?: string;
+    seller: string;
+    orderId: string | Uint8Array;
+    deliverableReference: string;
+}): SolanaCompiledInstruction;
+/**
+ * Encodes the release_funds instruction:
+ * accounts: [escrow_order (mut), vault (mut), buyer (signer), seller (mut), fee_recipient (mut)]
+ */
+export declare function createReleaseFundsInstruction(params: {
+    programId?: string;
+    buyer: string;
+    seller: string;
+    feeRecipient: string;
+    orderId: string | Uint8Array;
+}): SolanaCompiledInstruction;
+/**
+ * Encodes the cancel_or_refund instruction:
+ * accounts: [escrow_order (mut), vault (mut), caller (signer), buyer (mut), system_program]
+ */
+export declare function createCancelOrRefundInstruction(params: {
+    programId?: string;
+    caller: string;
+    buyer: string;
+    orderId: string | Uint8Array;
+    reason: string;
+}): SolanaCompiledInstruction;
+/**
+ * Encodes the dispute instruction:
+ * accounts: [escrow_order (mut), caller (signer)]
+ */
+export declare function createDisputeOrderInstruction(params: {
+    programId?: string;
+    caller: string;
+    orderId: string | Uint8Array;
+    reason: string;
+}): SolanaCompiledInstruction;
+/**
+ * Encodes the resolve_dispute instruction:
+ * accounts: [escrow_order (mut), vault (mut), reviewer (signer), buyer (mut), seller (mut),
+ *            fee_recipient (mut), system_program, config]
+ * The trailing read-only `config` PDA lets the upgraded program authorize the CURRENT platform
+ * reviewer; the pre-upgrade program ignores it as an Anchor remaining account.
+ */
+export declare function createResolveDisputeInstruction(params: {
+    programId?: string;
+    reviewer: string;
+    buyer: string;
+    seller: string;
+    feeRecipient: string;
+    orderId: string | Uint8Array;
+    splitToBuyerPercent: number;
+}): SolanaCompiledInstruction;
+/**
+ * Decodes serialized EscrowOrder account buffer.
+ */
+export declare function decodeEscrowOrderAccount(buffer: Uint8Array | Buffer): DecodedSolanaEscrowOrder;
+/**
+ * Calculates exact platform fee and payouts for Solana lamports.
+ * Strict parity with EVM: 500 bps (5%) platform fee deducted from seller gross award.
+ * Buyer refunds are 100% fee-free.
+ */
+export declare function calculateSolanaServicePayouts(totalLamports: bigint | number, splitToBuyerPercent?: number, feeBps?: number): {
+    buyerRefundLamports: bigint;
+    sellerGrossLamports: bigint;
+    platformFeeLamports: bigint;
+    sellerNetPayoutLamports: bigint;
+};
+/**
+ * Lossless conversion of lamports to a high-precision SOL string without floating-point errors.
+ */
+export declare function formatLamportsToSol(lamports: bigint | number): string;
+/**
+ * Lossless conversion of SOL string to lamports bigint without floating-point inaccuracies.
+ */
+export declare function parseSolToLamports(sol: string): bigint;
+//# sourceMappingURL=escrow.d.ts.map

package/dist/cjs/solana/escrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escrow.d.ts","sourceRoot":"","sources":["../../../src/solana/escrow.ts"],"names":[],"mappings":"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"}

package/dist/cjs/solana/escrow.js

@@ -0,0 +1,463 @@
+"use strict";
+/**
+ * VEILIO Solana Services Escrow Client & Program Interface
+ *
+ * Implements client-side PDA derivation, Anchor instruction serialization,
+ * account deserialization, fee calculations, and transaction verification
+ * for the dedicated Solana Devnet VeilServiceEscrow program.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SOLANA_SERVICE_ESCROW_STATUS_MAP = exports.DEFAULT_SOLANA_SERVICE_ESCROW_PROGRAM_ID = exports.ESCROW_CONFIG_ACCOUNT_SIZE = exports.ESCROW_CONFIG_SEED = exports.MAX_FEE_BPS = exports.MAX_DELIVERABLE_REF_LEN = exports.VAULT_SEED = exports.ESCROW_SEED = void 0;
+exports.findEscrowOrderPda = findEscrowOrderPda;
+exports.findVaultPda = findVaultPda;
+exports.findEscrowConfigPda = findEscrowConfigPda;
+exports.decodeEscrowConfigAccount = decodeEscrowConfigAccount;
+exports.createInitializeEscrowConfigInstruction = createInitializeEscrowConfigInstruction;
+exports.createUpdateEscrowConfigInstruction = createUpdateEscrowConfigInstruction;
+exports.createDepositServiceOrderInstruction = createDepositServiceOrderInstruction;
+exports.createSubmitDeliveryInstruction = createSubmitDeliveryInstruction;
+exports.createReleaseFundsInstruction = createReleaseFundsInstruction;
+exports.createCancelOrRefundInstruction = createCancelOrRefundInstruction;
+exports.createDisputeOrderInstruction = createDisputeOrderInstruction;
+exports.createResolveDisputeInstruction = createResolveDisputeInstruction;
+exports.decodeEscrowOrderAccount = decodeEscrowOrderAccount;
+exports.calculateSolanaServicePayouts = calculateSolanaServicePayouts;
+exports.formatLamportsToSol = formatLamportsToSol;
+exports.parseSolToLamports = parseSolToLamports;
+const registry_js_1 = require("./registry.js");
+// Canonical Seeds & Limits
+exports.ESCROW_SEED = Buffer.from('service_escrow');
+exports.VAULT_SEED = Buffer.from('service_vault');
+exports.MAX_DELIVERABLE_REF_LEN = 200;
+exports.MAX_FEE_BPS = 500; // 5%
+/** Global platform config PDA seed: [b"escrow_config"] (EscrowConfig account). */
+exports.ESCROW_CONFIG_SEED = Buffer.from('escrow_config');
+/** 8 (discriminator) + 32 admin + 32 reviewer + 32 fee_recipient + 2 fee_basis_points + 1 bump */
+exports.ESCROW_CONFIG_ACCOUNT_SIZE = 107;
+// Default Program ID (can be overridden via NEXT_PUBLIC_SOLANA_SERVICE_ESCROW_PROGRAM_ID)
+exports.DEFAULT_SOLANA_SERVICE_ESCROW_PROGRAM_ID = '5Vj4y8BT74PDe5VwLuDp9agTR5ak4vtZdwxnBfRW3R8s';
+exports.SOLANA_SERVICE_ESCROW_STATUS_MAP = {
+    0: 'None',
+    1: 'Funded',
+    2: 'Delivered',
+    3: 'Released',
+    4: 'Refunded',
+    5: 'Disputed',
+};
+/**
+ * Derives the EscrowOrder account PDA: [b"service_escrow", order_id]
+ */
+function findEscrowOrderPda(orderId, programId = exports.DEFAULT_SOLANA_SERVICE_ESCROW_PROGRAM_ID) {
+    const orderIdBytes = (0, registry_js_1.normalizeBytes32)(orderId);
+    return (0, registry_js_1.findProgramDerivedAddress)([exports.ESCROW_SEED, orderIdBytes], programId);
+}
+/**
+ * Derives the Vault account PDA holding SOL lamports: [b"service_vault", order_id]
+ */
+function findVaultPda(orderId, programId = exports.DEFAULT_SOLANA_SERVICE_ESCROW_PROGRAM_ID) {
+    const orderIdBytes = (0, registry_js_1.normalizeBytes32)(orderId);
+    return (0, registry_js_1.findProgramDerivedAddress)([exports.VAULT_SEED, orderIdBytes], programId);
+}
+/**
+ * Derives the global EscrowConfig PDA: [b"escrow_config"]. Holds the platform reviewer, fee
+ * recipient and fee rate that the upgraded program snapshots into every new order.
+ */
+function findEscrowConfigPda(programId = exports.DEFAULT_SOLANA_SERVICE_ESCROW_PROGRAM_ID) {
+    return (0, registry_js_1.findProgramDerivedAddress)([exports.ESCROW_CONFIG_SEED], programId);
+}
+/** Decodes the EscrowConfig account (admin, reviewer, fee_recipient, fee_basis_points u16, bump). */
+function decodeEscrowConfigAccount(buffer) {
+    const buf = Buffer.from(buffer);
+    if (buf.length < exports.ESCROW_CONFIG_ACCOUNT_SIZE) {
+        throw new Error(`Truncated EscrowConfig buffer length: ${buf.length}`);
+    }
+    if (!buf.subarray(0, 8).equals((0, registry_js_1.getAnchorDiscriminator)('account', 'EscrowConfig'))) {
+        throw new Error('Invalid account discriminator for EscrowConfig');
+    }
+    let offset = 8;
+    const admin = (0, registry_js_1.encodeBase58)(buf.subarray(offset, offset + 32));
+    offset += 32;
+    const reviewer = (0, registry_js_1.encodeBase58)(buf.subarray(offset, offset + 32));
+    offset += 32;
+    const feeRecipient = (0, registry_js_1.encodeBase58)(buf.subarray(offset, offset + 32));
+    offset += 32;
+    const feeBasisPoints = buf.readUInt16LE(offset);
+    offset += 2;
+    const bump = buf.readUInt8(offset);
+    return { admin, reviewer, feeRecipient, feeBasisPoints, bump };
+}
+function validateEscrowConfigParams(params) {
+    const reviewerBytes = (0, registry_js_1.decodePubkey32)(params.reviewer, 'reviewer');
+    const feeRecipientBytes = (0, registry_js_1.decodePubkey32)(params.feeRecipient, 'fee recipient');
+    if (reviewerBytes.every((b) => b === 0))
+        throw new Error('Reviewer cannot be the default (all-zero) public key');
+    if (feeRecipientBytes.every((b) => b === 0))
+        throw new Error('Fee recipient cannot be the default (all-zero) public key');
+    if (!Number.isInteger(params.feeBasisPoints) || params.feeBasisPoints < 0 || params.feeBasisPoints > exports.MAX_FEE_BPS) {
+        throw new Error(`Fee basis points must be an integer between 0 and ${exports.MAX_FEE_BPS}`);
+    }
+    const feeBuf = Buffer.alloc(2);
+    feeBuf.writeUInt16LE(params.feeBasisPoints);
+    return { reviewerBytes, feeRecipientBytes, feeBuf };
+}
+/**
+ * Encodes initialize_config(reviewer, fee_recipient, fee_basis_points). Only the program's
+ * upgrade authority (`admin`) can call it, once.
+ * accounts: [config (mut, pda), admin (signer, mut), program, program_data, system_program]
+ */
+function createInitializeEscrowConfigInstruction(params) {
+    const programId = params.programId || exports.DEFAULT_SOLANA_SERVICE_ESCROW_PROGRAM_ID;
+    const { reviewerBytes, feeRecipientBytes, feeBuf } = validateEscrowConfigParams(params);
+    const { pda: configPda } = findEscrowConfigPda(programId);
+    const { pda: programDataPda } = (0, registry_js_1.findProgramDataPda)(programId);
+    const data = Buffer.concat([
+        (0, registry_js_1.getAnchorDiscriminator)('global', 'initialize_config'),
+        reviewerBytes,
+        feeRecipientBytes,
+        feeBuf,
+    ]);
+    const keys = [
+        { pubkey: configPda, isSigner: false, isWritable: true },
+        { pubkey: params.admin, isSigner: true, isWritable: true },
+        { pubkey: programId, isSigner: false, isWritable: false },
+        { pubkey: programDataPda, isSigner: false, isWritable: false },
+        { pubkey: registry_js_1.SYSTEM_PROGRAM_ID, isSigner: false, isWritable: false },
+    ];
+    return { programId, accounts: keys, keys, data };
+}
+/**
+ * Encodes update_config(reviewer, fee_recipient, fee_basis_points, new_admin). Signed by the
+ * current config admin; `newAdmin` defaults to `admin` (no hand-over).
+ * accounts: [config (mut, pda), admin (signer)]
+ */
+function createUpdateEscrowConfigInstruction(params) {
+    const programId = params.programId || exports.DEFAULT_SOLANA_SERVICE_ESCROW_PROGRAM_ID;
+    const { reviewerBytes, feeRecipientBytes, feeBuf } = validateEscrowConfigParams(params);
+    const newAdminBytes = (0, registry_js_1.decodePubkey32)(params.newAdmin || params.admin, 'new admin');
+    if (newAdminBytes.every((b) => b === 0))
+        throw new Error('New admin cannot be the default (all-zero) public key');
+    const { pda: configPda } = findEscrowConfigPda(programId);
+    const data = Buffer.concat([
+        (0, registry_js_1.getAnchorDiscriminator)('global', 'update_config'),
+        reviewerBytes,
+        feeRecipientBytes,
+        feeBuf,
+        newAdminBytes,
+    ]);
+    const keys = [
+        { pubkey: configPda, isSigner: false, isWritable: true },
+        { pubkey: params.admin, isSigner: true, isWritable: false },
+    ];
+    return { programId, accounts: keys, keys, data };
+}
+/**
+ * Encodes the deposit instruction:
+ * accounts: [escrow_order (mut, pda), vault (mut, pda), buyer (signer, mut), system_program, config]
+ *
+ * The trailing read-only `config` PDA is required by the upgraded program (which takes the
+ * reviewer / fee recipient / fee rate from it and ignores the `reviewer` / `feeRecipient`
+ * args). The pre-upgrade program ignores it as an Anchor remaining account.
+ */
+function createDepositServiceOrderInstruction(params) {
+    const programId = params.programId || exports.DEFAULT_SOLANA_SERVICE_ESCROW_PROGRAM_ID;
+    const orderIdBytes = (0, registry_js_1.normalizeBytes32)(params.orderId);
+    const { pda: escrowOrderPda } = findEscrowOrderPda(orderIdBytes, programId);
+    const { pda: vaultPda } = findVaultPda(orderIdBytes, programId);
+    const amount = BigInt(params.amountLamports);
+    if (amount <= 0n)
+        throw new Error('Deposit amount must be greater than zero');
+    if (params.seller === params.buyer)
+        throw new Error('Buyer cannot be seller');
+    const discriminator = (0, registry_js_1.getAnchorDiscriminator)('global', 'deposit');
+    const sellerBytes = Buffer.from((0, registry_js_1.decodeBase58)(params.seller));
+    const reviewerBytes = Buffer.from((0, registry_js_1.decodeBase58)(params.reviewer));
+    const feeRecipientBytes = Buffer.from((0, registry_js_1.decodeBase58)(params.feeRecipient));
+    const amountBuf = Buffer.alloc(8);
+    amountBuf.writeBigUInt64LE(amount);
+    const deadlineBuf = Buffer.alloc(8);
+    deadlineBuf.writeBigInt64LE(BigInt(params.deadline));
+    const data = Buffer.concat([
+        discriminator,
+        orderIdBytes,
+        sellerBytes,
+        reviewerBytes,
+        feeRecipientBytes,
+        amountBuf,
+        deadlineBuf,
+    ]);
+    const keys = [
+        { pubkey: escrowOrderPda, isSigner: false, isWritable: true },
+        { pubkey: vaultPda, isSigner: false, isWritable: true },
+        { pubkey: params.buyer, isSigner: true, isWritable: true },
+        { pubkey: registry_js_1.SYSTEM_PROGRAM_ID, isSigner: false, isWritable: false },
+        { pubkey: findEscrowConfigPda(programId).pda, isSigner: false, isWritable: false },
+    ];
+    return {
+        programId,
+        accounts: keys,
+        keys,
+        data: Buffer.from(data),
+    };
+}
+/**
+ * Encodes the submit_delivery instruction:
+ * accounts: [escrow_order (mut), seller (signer)]
+ */
+function createSubmitDeliveryInstruction(params) {
+    const programId = params.programId || exports.DEFAULT_SOLANA_SERVICE_ESCROW_PROGRAM_ID;
+    const orderIdBytes = (0, registry_js_1.normalizeBytes32)(params.orderId);
+    const { pda: escrowOrderPda } = findEscrowOrderPda(orderIdBytes, programId);
+    const refStr = params.deliverableReference.trim();
+    if (!refStr)
+        throw new Error('Deliverable reference cannot be empty');
+    const refBuf = Buffer.from(refStr, 'utf8');
+    if (refBuf.length > exports.MAX_DELIVERABLE_REF_LEN) {
+        throw new Error(`Deliverable reference exceeds ${exports.MAX_DELIVERABLE_REF_LEN} bytes`);
+    }
+    const discriminator = (0, registry_js_1.getAnchorDiscriminator)('global', 'submit_delivery');
+    const lenBuf = Buffer.alloc(4);
+    lenBuf.writeUInt32LE(refBuf.length);
+    const data = Buffer.concat([discriminator, lenBuf, refBuf]);
+    const keys = [
+        { pubkey: escrowOrderPda, isSigner: false, isWritable: true },
+        { pubkey: params.seller, isSigner: true, isWritable: false },
+    ];
+    return {
+        programId,
+        accounts: keys,
+        keys,
+        data: Buffer.from(data),
+    };
+}
+/**
+ * Encodes the release_funds instruction:
+ * accounts: [escrow_order (mut), vault (mut), buyer (signer), seller (mut), fee_recipient (mut)]
+ */
+function createReleaseFundsInstruction(params) {
+    const programId = params.programId || exports.DEFAULT_SOLANA_SERVICE_ESCROW_PROGRAM_ID;
+    const orderIdBytes = (0, registry_js_1.normalizeBytes32)(params.orderId);
+    const { pda: escrowOrderPda } = findEscrowOrderPda(orderIdBytes, programId);
+    const { pda: vaultPda } = findVaultPda(orderIdBytes, programId);
+    const discriminator = (0, registry_js_1.getAnchorDiscriminator)('global', 'release_funds');
+    const keys = [
+        { pubkey: escrowOrderPda, isSigner: false, isWritable: true },
+        { pubkey: vaultPda, isSigner: false, isWritable: true },
+        { pubkey: params.buyer, isSigner: true, isWritable: false },
+        { pubkey: params.seller, isSigner: false, isWritable: true },
+        { pubkey: params.feeRecipient, isSigner: false, isWritable: true },
+        { pubkey: registry_js_1.SYSTEM_PROGRAM_ID, isSigner: false, isWritable: false },
+    ];
+    return {
+        programId,
+        accounts: keys,
+        keys,
+        data: Buffer.from(discriminator),
+    };
+}
+/**
+ * Encodes the cancel_or_refund instruction:
+ * accounts: [escrow_order (mut), vault (mut), caller (signer), buyer (mut), system_program]
+ */
+function createCancelOrRefundInstruction(params) {
+    const programId = params.programId || exports.DEFAULT_SOLANA_SERVICE_ESCROW_PROGRAM_ID;
+    const orderIdBytes = (0, registry_js_1.normalizeBytes32)(params.orderId);
+    const { pda: escrowOrderPda } = findEscrowOrderPda(orderIdBytes, programId);
+    const { pda: vaultPda } = findVaultPda(orderIdBytes, programId);
+    const discriminator = (0, registry_js_1.getAnchorDiscriminator)('global', 'cancel_or_refund');
+    const reasonBuf = Buffer.from(params.reason.trim() || 'Order cancelled', 'utf8');
+    const lenBuf = Buffer.alloc(4);
+    lenBuf.writeUInt32LE(reasonBuf.length);
+    const data = Buffer.concat([discriminator, lenBuf, reasonBuf]);
+    const keys = [
+        { pubkey: escrowOrderPda, isSigner: false, isWritable: true },
+        { pubkey: vaultPda, isSigner: false, isWritable: true },
+        { pubkey: params.caller, isSigner: true, isWritable: false },
+        { pubkey: params.buyer, isSigner: false, isWritable: true },
+        { pubkey: registry_js_1.SYSTEM_PROGRAM_ID, isSigner: false, isWritable: false },
+    ];
+    return {
+        programId,
+        accounts: keys,
+        keys,
+        data: Buffer.from(data),
+    };
+}
+/**
+ * Encodes the dispute instruction:
+ * accounts: [escrow_order (mut), caller (signer)]
+ */
+function createDisputeOrderInstruction(params) {
+    const programId = params.programId || exports.DEFAULT_SOLANA_SERVICE_ESCROW_PROGRAM_ID;
+    const orderIdBytes = (0, registry_js_1.normalizeBytes32)(params.orderId);
+    const { pda: escrowOrderPda } = findEscrowOrderPda(orderIdBytes, programId);
+    const discriminator = (0, registry_js_1.getAnchorDiscriminator)('global', 'dispute');
+    const reasonBuf = Buffer.from(params.reason.trim() || 'Dispute opened', 'utf8');
+    const lenBuf = Buffer.alloc(4);
+    lenBuf.writeUInt32LE(reasonBuf.length);
+    const data = Buffer.concat([discriminator, lenBuf, reasonBuf]);
+    const keys = [
+        { pubkey: escrowOrderPda, isSigner: false, isWritable: true },
+        { pubkey: params.caller, isSigner: true, isWritable: false },
+    ];
+    return {
+        programId,
+        accounts: keys,
+        keys,
+        data: Buffer.from(data),
+    };
+}
+/**
+ * Encodes the resolve_dispute instruction:
+ * accounts: [escrow_order (mut), vault (mut), reviewer (signer), buyer (mut), seller (mut),
+ *            fee_recipient (mut), system_program, config]
+ * The trailing read-only `config` PDA lets the upgraded program authorize the CURRENT platform
+ * reviewer; the pre-upgrade program ignores it as an Anchor remaining account.
+ */
+function createResolveDisputeInstruction(params) {
+    const programId = params.programId || exports.DEFAULT_SOLANA_SERVICE_ESCROW_PROGRAM_ID;
+    const orderIdBytes = (0, registry_js_1.normalizeBytes32)(params.orderId);
+    const { pda: escrowOrderPda } = findEscrowOrderPda(orderIdBytes, programId);
+    const { pda: vaultPda } = findVaultPda(orderIdBytes, programId);
+    if (params.splitToBuyerPercent < 0 || params.splitToBuyerPercent > 100) {
+        throw new Error('Split percentage must be between 0 and 100');
+    }
+    const discriminator = (0, registry_js_1.getAnchorDiscriminator)('global', 'resolve_dispute');
+    const splitBuf = Buffer.from([params.splitToBuyerPercent]);
+    const data = Buffer.concat([discriminator, splitBuf]);
+    const keys = [
+        { pubkey: escrowOrderPda, isSigner: false, isWritable: true },
+        { pubkey: vaultPda, isSigner: false, isWritable: true },
+        { pubkey: params.reviewer, isSigner: true, isWritable: false },
+        { pubkey: params.buyer, isSigner: false, isWritable: true },
+        { pubkey: params.seller, isSigner: false, isWritable: true },
+        { pubkey: params.feeRecipient, isSigner: false, isWritable: true },
+        { pubkey: registry_js_1.SYSTEM_PROGRAM_ID, isSigner: false, isWritable: false },
+        { pubkey: findEscrowConfigPda(programId).pda, isSigner: false, isWritable: false },
+    ];
+    return {
+        programId,
+        accounts: keys,
+        keys,
+        data: Buffer.from(data),
+    };
+}
+/**
+ * Decodes serialized EscrowOrder account buffer.
+ */
+function decodeEscrowOrderAccount(buffer) {
+    const buf = Buffer.from(buffer);
+    const expectedDiscriminator = (0, registry_js_1.getAnchorDiscriminator)('account', 'EscrowOrder');
+    if (buf.length < 8 + 32 * 4 + 32 + 8 + 2 + 8 + 1 + 8 + 8 + 4 + 1 + 1) {
+        throw new Error(`Truncated account buffer length: ${buf.length}`);
+    }
+    const accountDiscriminator = buf.subarray(0, 8);
+    if (!accountDiscriminator.equals(expectedDiscriminator)) {
+        throw new Error('Invalid account discriminator for EscrowOrder');
+    }
+    let offset = 8;
+    const buyer = (0, registry_js_1.encodeBase58)(buf.subarray(offset, offset + 32));
+    offset += 32;
+    const seller = (0, registry_js_1.encodeBase58)(buf.subarray(offset, offset + 32));
+    offset += 32;
+    const reviewer = (0, registry_js_1.encodeBase58)(buf.subarray(offset, offset + 32));
+    offset += 32;
+    const feeRecipient = (0, registry_js_1.encodeBase58)(buf.subarray(offset, offset + 32));
+    offset += 32;
+    const orderIdBytes = new Uint8Array(buf.subarray(offset, offset + 32));
+    const orderIdHex = '0x' + Buffer.from(orderIdBytes).toString('hex');
+    offset += 32;
+    const amountLamports = buf.readBigUInt64LE(offset);
+    offset += 8;
+    const feeBasisPoints = buf.readUInt16LE(offset);
+    offset += 2;
+    const deadline = Number(buf.readBigInt64LE(offset));
+    offset += 8;
+    const statusNum = buf.readUInt8(offset);
+    const status = exports.SOLANA_SERVICE_ESCROW_STATUS_MAP[statusNum] || 'None';
+    offset += 1;
+    const createdAt = Number(buf.readBigInt64LE(offset));
+    offset += 8;
+    const settledAt = Number(buf.readBigInt64LE(offset));
+    offset += 8;
+    const strLen = buf.readUInt32LE(offset);
+    offset += 4;
+    const deliverableReference = buf.subarray(offset, offset + strLen).toString('utf8');
+    offset += strLen;
+    const bump = buf.readUInt8(offset);
+    offset += 1;
+    const vaultBump = buf.readUInt8(offset);
+    const solDecimals = 9;
+    const amountSol = (Number(amountLamports) / 10 ** solDecimals).toFixed(4);
+    return {
+        buyer,
+        seller,
+        reviewer,
+        feeRecipient,
+        orderIdHex,
+        orderIdBytes,
+        amountLamports,
+        amountSol,
+        feeBasisPoints,
+        deadline,
+        status,
+        createdAt,
+        settledAt,
+        deliverableReference,
+        bump,
+        vaultBump,
+    };
+}
+/**
+ * Calculates exact platform fee and payouts for Solana lamports.
+ * Strict parity with EVM: 500 bps (5%) platform fee deducted from seller gross award.
+ * Buyer refunds are 100% fee-free.
+ */
+function calculateSolanaServicePayouts(totalLamports, splitToBuyerPercent = 0, feeBps = 500) {
+    const total = BigInt(totalLamports);
+    const buyerPercent = BigInt(Math.min(Math.max(splitToBuyerPercent, 0), 100));
+    const buyerRefundLamports = (total * buyerPercent) / 100n;
+    const sellerGrossLamports = total - buyerRefundLamports;
+    // Platform fee applies only to seller gross
+    const platformFeeLamports = (sellerGrossLamports * BigInt(feeBps)) / 10000n;
+    const sellerNetPayoutLamports = sellerGrossLamports - platformFeeLamports;
+    return {
+        buyerRefundLamports,
+        sellerGrossLamports,
+        platformFeeLamports,
+        sellerNetPayoutLamports,
+    };
+}
+/**
+ * Lossless conversion of lamports to a high-precision SOL string without floating-point errors.
+ */
+function formatLamportsToSol(lamports) {
+    const value = BigInt(lamports);
+    const negative = value < 0n;
+    const absVal = negative ? -value : value;
+    const intPart = absVal / 1000000000n;
+    const rem = absVal % 1000000000n;
+    if (rem === 0n) {
+        return (negative ? '-' : '') + intPart.toString();
+    }
+    const frac = rem.toString().padStart(9, '0').replace(/0+$/, '');
+    return (negative ? '-' : '') + `${intPart}.${frac}`;
+}
+/**
+ * Lossless conversion of SOL string to lamports bigint without floating-point inaccuracies.
+ */
+function parseSolToLamports(sol) {
+    const trimmed = sol.trim();
+    if (!trimmed || !/^-?\d+(\.\d+)?$/.test(trimmed)) {
+        throw new Error(`Invalid SOL amount string: "${sol}"`);
+    }
+    const negative = trimmed.startsWith('-');
+    const unsigned = negative ? trimmed.slice(1) : trimmed;
+    const [intStr, fracStr = ''] = unsigned.split('.');
+    if (fracStr.length > 9) {
+        throw new Error(`SOL amount has more than 9 decimal places: "${sol}"`);
+    }
+    const paddedFrac = fracStr.padEnd(9, '0');
+    const lamports = BigInt(intStr) * 1000000000n + BigInt(paddedFrac);
+    return negative ? -lamports : lamports;
+}
+//# sourceMappingURL=escrow.js.map