veilioexchange 0.1.0 → 0.2.0

package/dist/esm/solana/client.js

@@ -0,0 +1,274 @@
+import { randomBytes } from 'node:crypto';
+import { LAMPORTS_PER_SOL, PublicKey, Transaction, TransactionInstruction, } from '@solana/web3.js';
+import { VeilioSdkError } from '../errors.js';
+import { DEFAULT_SOLANA_AUCTION_PROGRAM_ID, computeSealedBidCommitment, createAcceptDatasetInstruction, createClaimRefundInstruction, createCommitBidInstruction, createRevealBidInstruction, decodeAuctionStateAccount, findAuctionPda, } from './auction.js';
+import { DEFAULT_SOLANA_SERVICE_ESCROW_PROGRAM_ID, createCancelOrRefundInstruction, createDepositServiceOrderInstruction, createDisputeOrderInstruction, createReleaseFundsInstruction, createSubmitDeliveryInstruction, decodeEscrowOrderAccount, findEscrowOrderPda, } from './escrow.js';
+import { encodeBase58, getAnchorDiscriminator } from './registry.js';
+/** Wraps a Keypair (e.g. an agent's devnet key) as a SolanaSigner. */
+export function keypairSigner(keypair) {
+    return {
+        publicKey: keypair.publicKey,
+        async signTransaction(transaction) {
+            transaction.partialSign(keypair);
+            return transaction;
+        },
+    };
+}
+/**
+ * Encodes an order ID into the 32-byte seed the escrow program expects.
+ * Accepts a 64-char hex string as-is; otherwise UTF-8 bytes right-padded with zeros
+ * (same encoding the EVM escrow uses), up to 32 bytes.
+ */
+export function toSolanaOrderId(orderId) {
+    const hex = orderId.startsWith('0x') ? orderId.slice(2) : orderId;
+    if (/^[0-9a-fA-F]{64}$/.test(hex))
+        return hex.toLowerCase();
+    const bytes = Buffer.from(orderId, 'utf8');
+    if (bytes.length === 0 || bytes.length > 32) {
+        throw new VeilioSdkError({ code: 'INVALID_INPUT', message: 'orderId must be 1 to 32 bytes of UTF-8, or 32 bytes of hex.' });
+    }
+    return Buffer.concat([bytes, Buffer.alloc(32 - bytes.length)]).toString('hex');
+}
+/** Converts a decimal SOL string to lamports without floating-point rounding. */
+export function solToLamports(sol) {
+    const trimmed = sol.trim();
+    if (!/^\d+(\.\d{1,9})?$/.test(trimmed)) {
+        throw new VeilioSdkError({ code: 'INVALID_INPUT', message: `Invalid SOL amount: "${sol}" (max 9 decimals).` });
+    }
+    const [whole, fraction = ''] = trimmed.split('.');
+    return BigInt(whole) * BigInt(LAMPORTS_PER_SOL) + BigInt(fraction.padEnd(9, '0'));
+}
+/**
+ * Validates a base58 address. A lowercased address often still decodes to 32 bytes, so it would
+ * silently point at the wrong account; real addresses with no uppercase letter are vanishingly rare.
+ */
+export function assertSolanaAddress(label, value) {
+    let valid = true;
+    try {
+        new PublicKey(value);
+    }
+    catch {
+        valid = false;
+    }
+    if (!valid || value === value.toLowerCase()) {
+        throw new VeilioSdkError({
+            code: 'INVALID_INPUT',
+            message: `${label} is not a valid Solana address. Base58 is case-sensitive: never lowercase it.`,
+        });
+    }
+}
+function toTransactionInstruction(ix) {
+    return new TransactionInstruction({
+        programId: new PublicKey(ix.programId),
+        keys: ix.accounts.map((meta) => ({
+            pubkey: new PublicKey(meta.pubkey),
+            isSigner: meta.isSigner,
+            isWritable: meta.isWritable,
+        })),
+        data: Buffer.from(ix.data),
+    });
+}
+/**
+ * High-level client for VEILIO on Solana Devnet: sealed-bid auctions and service escrow.
+ * Node.js 18+ (uses node:crypto and Buffer).
+ */
+export function createVeilioSolanaClient(options) {
+    const { connection } = options;
+    const commitment = options.commitment ?? 'confirmed';
+    const auctionProgramId = options.auctionProgramId ?? DEFAULT_SOLANA_AUCTION_PROGRAM_ID;
+    const escrowProgramId = options.escrowProgramId ?? DEFAULT_SOLANA_SERVICE_ESCROW_PROGRAM_ID;
+    function requireSigner() {
+        if (!options.signer) {
+            throw new VeilioSdkError({ code: 'WALLET_REQUIRED', message: 'A Solana signer is required to send transactions.' });
+        }
+        return options.signer;
+    }
+    async function send(ix) {
+        const signer = requireSigner();
+        const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash(commitment);
+        const tx = new Transaction({ feePayer: signer.publicKey, blockhash, lastValidBlockHeight }).add(toTransactionInstruction(ix));
+        const signed = await signer.signTransaction(tx);
+        const signature = await connection.sendRawTransaction(signed.serialize());
+        const result = await connection.confirmTransaction({ signature, blockhash, lastValidBlockHeight }, commitment);
+        if (result.value.err) {
+            throw new VeilioSdkError({
+                code: 'TRANSACTION_REVERTED',
+                message: `Solana transaction failed: ${JSON.stringify(result.value.err)}`,
+                context: { signature },
+            });
+        }
+        return signature;
+    }
+    // ---------------------------------------------------------------- Auctions
+    async function getAuction(auctionId) {
+        const { pda } = findAuctionPda(BigInt(auctionId), auctionProgramId);
+        const account = await connection.getAccountInfo(new PublicKey(pda), commitment);
+        return account ? decodeAuctionStateAccount(account.data) : null;
+    }
+    async function listAuctions() {
+        const discriminator = encodeBase58(getAnchorDiscriminator('account', 'AuctionStateAccount'));
+        const accounts = await connection.getProgramAccounts(new PublicKey(auctionProgramId), {
+            commitment,
+            filters: [{ memcmp: { offset: 0, bytes: discriminator } }],
+        });
+        const auctions = [];
+        for (const { pubkey, account } of accounts) {
+            try {
+                auctions.push({ ...decodeAuctionStateAccount(account.data), address: pubkey.toBase58() });
+            }
+            catch {
+                // Skip accounts from an older layout instead of failing the whole listing.
+            }
+        }
+        return auctions.sort((a, b) => Number(b.auctionId - a.auctionId));
+    }
+    function prepareBid(auctionId, maxBidSol) {
+        const bidder = requireSigner().publicKey.toBase58();
+        const id = BigInt(auctionId);
+        const maxBidLamports = solToLamports(maxBidSol);
+        if (id < 0n || maxBidLamports <= 0n) {
+            throw new VeilioSdkError({ code: 'INVALID_INPUT', message: 'auctionId must be >= 0 and maxBid must be positive.' });
+        }
+        const salt = randomBytes(32);
+        const { pda: auctionPda } = findAuctionPda(id, auctionProgramId);
+        const commitmentHash = computeSealedBidCommitment({ auctionPubkey: auctionPda, bidderPubkey: bidder, maxBidLamports, salt });
+        return {
+            auctionId: id.toString(),
+            bidder,
+            maxBidLamports: maxBidLamports.toString(),
+            salt: salt.toString('hex'),
+            commitment: commitmentHash.toString('hex'),
+            programId: auctionProgramId,
+        };
+    }
+    /** Commits the sealed bid. Deposit must cover the max bid; over-deposit to hide your ceiling. */
+    async function commitBid(prepared, depositSol) {
+        const depositLamports = solToLamports(depositSol);
+        if (depositLamports < BigInt(prepared.maxBidLamports)) {
+            throw new VeilioSdkError({ code: 'INVALID_INPUT', message: 'Deposit must cover the maximum bid.' });
+        }
+        return send(createCommitBidInstruction({
+            programId: prepared.programId,
+            auctionId: BigInt(prepared.auctionId),
+            bidder: prepared.bidder,
+            commitment: Buffer.from(prepared.commitment, 'hex'),
+            depositLamports,
+        }));
+    }
+    async function revealBid(prepared) {
+        return send(createRevealBidInstruction({
+            programId: prepared.programId,
+            auctionId: BigInt(prepared.auctionId),
+            bidder: prepared.bidder,
+            maxBidLamports: BigInt(prepared.maxBidLamports),
+            salt: Buffer.from(prepared.salt, 'hex'),
+        }));
+    }
+    /** Winner accepts the asset during inspection, releasing payment to the seller. */
+    async function acceptDataset(auctionId, seller) {
+        return send(createAcceptDatasetInstruction({
+            programId: auctionProgramId,
+            auctionId: BigInt(auctionId),
+            seller,
+            winner: requireSigner().publicKey.toBase58(),
+        }));
+    }
+    /** Losing bidders reclaim their deposit after settlement. */
+    async function claimRefund(auctionId) {
+        return send(createClaimRefundInstruction({
+            programId: auctionProgramId,
+            auctionId: BigInt(auctionId),
+            bidder: requireSigner().publicKey.toBase58(),
+        }));
+    }
+    // ---------------------------------------------------------- Service escrow
+    async function getEscrowOrder(orderId) {
+        const { pda } = findEscrowOrderPda(toSolanaOrderId(orderId), escrowProgramId);
+        const account = await connection.getAccountInfo(new PublicKey(pda), commitment);
+        return account ? decodeEscrowOrderAccount(account.data) : null;
+    }
+    async function deposit(input) {
+        if (input.reviewer === escrowProgramId || input.reviewer === auctionProgramId) {
+            throw new VeilioSdkError({
+                code: 'INVALID_INPUT',
+                message: 'reviewer must be a wallet that can sign; a program ID can never resolve a dispute.',
+            });
+        }
+        for (const [label, value] of [['seller', input.seller], ['reviewer', input.reviewer], ['feeRecipient', input.feeRecipient]]) {
+            assertSolanaAddress(label, value);
+        }
+        if (input.deadline <= Math.floor(Date.now() / 1000)) {
+            throw new VeilioSdkError({ code: 'INVALID_INPUT', message: 'Deadline must be in the future.' });
+        }
+        return send(createDepositServiceOrderInstruction({
+            programId: escrowProgramId,
+            buyer: requireSigner().publicKey.toBase58(),
+            seller: input.seller,
+            reviewer: input.reviewer,
+            feeRecipient: input.feeRecipient,
+            orderId: toSolanaOrderId(input.orderId),
+            amountLamports: solToLamports(input.amountSol),
+            deadline: input.deadline,
+        }));
+    }
+    async function submitDelivery(orderId, deliverableReference) {
+        return send(createSubmitDeliveryInstruction({
+            programId: escrowProgramId,
+            seller: requireSigner().publicKey.toBase58(),
+            orderId: toSolanaOrderId(orderId),
+            deliverableReference,
+        }));
+    }
+    /** Buyer releases escrow to the seller (5% fee to feeRecipient). Accounts are read from the order. */
+    async function releaseFunds(orderId) {
+        const order = await getEscrowOrder(orderId);
+        if (!order)
+            throw new VeilioSdkError({ code: 'NOT_FOUND', message: `Escrow order ${orderId} not found on Solana.` });
+        return send(createReleaseFundsInstruction({
+            programId: escrowProgramId,
+            buyer: requireSigner().publicKey.toBase58(),
+            seller: order.seller,
+            feeRecipient: order.feeRecipient,
+            orderId: toSolanaOrderId(orderId),
+        }));
+    }
+    /** Seller cancellation, or buyer refund after the deadline. Fee-free. */
+    async function refund(orderId, reason) {
+        const order = await getEscrowOrder(orderId);
+        if (!order)
+            throw new VeilioSdkError({ code: 'NOT_FOUND', message: `Escrow order ${orderId} not found on Solana.` });
+        return send(createCancelOrRefundInstruction({
+            programId: escrowProgramId,
+            caller: requireSigner().publicKey.toBase58(),
+            buyer: order.buyer,
+            orderId: toSolanaOrderId(orderId),
+            reason,
+        }));
+    }
+    async function dispute(orderId, reason) {
+        return send(createDisputeOrderInstruction({
+            programId: escrowProgramId,
+            caller: requireSigner().publicKey.toBase58(),
+            orderId: toSolanaOrderId(orderId),
+            reason,
+        }));
+    }
+    return {
+        auctionProgramId,
+        escrowProgramId,
+        getAuction,
+        listAuctions,
+        prepareBid,
+        commitBid,
+        revealBid,
+        acceptDataset,
+        claimRefund,
+        getEscrowOrder,
+        deposit,
+        submitDelivery,
+        releaseFunds,
+        refund,
+        dispute,
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/solana/client.js.map

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

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

@@ -0,0 +1,140 @@
+/**
+ * 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;
+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;
+};
+/**
+ * Encodes the deposit instruction:
+ * accounts: [escrow_order (mut, pda), vault (mut, pda), buyer (signer, mut), system_program]
+ */
+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)]
+ */
+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/esm/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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"}