veilioexchange 0.1.0 → 0.3.0

package/dist/cjs/servicesApi.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVeilioServicesApi = createVeilioServicesApi;
+const errors_js_1 = require("./errors.js");
+const auth_js_1 = require("./auth.js");
+function createVeilioServicesApi(options) {
+    const base = String(options.apiBaseUrl || '').replace(/\/+$/, '');
+    if (!/^https?:\/\//.test(base)) {
+        throw new errors_js_1.VeilioSdkError({ code: 'INVALID_CONFIG', message: 'apiBaseUrl must be an absolute http(s) URL.' });
+    }
+    if (!options.signer?.address || typeof options.signer.signMessage !== 'function') {
+        throw new errors_js_1.VeilioSdkError({ code: 'WALLET_REQUIRED', message: 'A signer with address and signMessage() is required.' });
+    }
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    if (typeof fetchImpl !== 'function') {
+        throw new errors_js_1.VeilioSdkError({ code: 'INVALID_CONFIG', message: 'No fetch implementation available; pass options.fetch.' });
+    }
+    const signer = options.signer;
+    function requireOrderId(orderId) {
+        const id = String(orderId ?? '').trim();
+        if (!id)
+            throw new errors_js_1.VeilioSdkError({ code: 'INVALID_INPUT', message: 'orderId is required.' });
+        return id;
+    }
+    async function parse(res, route, id) {
+        let json = null;
+        try {
+            json = await res.json();
+        }
+        catch {
+            // Non-JSON response; handled below.
+        }
+        if (!res.ok) {
+            throw new errors_js_1.VeilioSdkError({
+                code: res.status === 401 || res.status === 403 ? 'UNAUTHORIZED' : res.status === 404 ? 'NOT_FOUND' : 'INVALID_INPUT',
+                message: `VEILIO API ${route} failed (${res.status}): ${json?.error || res.statusText || 'unknown error'}`,
+                retryable: res.status >= 500,
+                context: { status: res.status, id, route },
+            });
+        }
+        return json;
+    }
+    async function request(url, init) {
+        try {
+            return await fetchImpl(url, init);
+        }
+        catch (cause) {
+            throw new errors_js_1.VeilioSdkError({ code: 'RPC_ERROR', message: `VEILIO API request failed: ${url}`, retryable: true, cause });
+        }
+    }
+    // ------------------------------------------------------------- read session
+    let session = null;
+    let pendingSession = null;
+    /** Cached read/chat session; signs a new one when missing or within a minute of expiry. */
+    async function getSession() {
+        if (session && (0, auth_js_1.isServiceSessionFresh)(session, signer.address))
+            return session;
+        if (!pendingSession) {
+            pendingSession = (0, auth_js_1.signServiceSession)(signer).finally(() => {
+                pendingSession = null;
+            });
+        }
+        session = await pendingSession;
+        return session;
+    }
+    /** `x-veilio-auth` header map for custom GET requests. */
+    async function getSessionHeaders() {
+        return (0, auth_js_1.encodeServiceAuthHeader)(await getSession());
+    }
+    async function get(path, label, id) {
+        const res = await request(`${base}${path}`, { method: 'GET', headers: await getSessionHeaders() });
+        return parse(res, label, id);
+    }
+    /** Order as seen by the VEILIO app (status, paymentStatus, network...). Buyer or seller only. */
+    async function getOrder(orderId) {
+        const id = requireOrderId(orderId);
+        return get(`/api/orders/${encodeURIComponent(id)}`, 'get-order', id);
+    }
+    /** Payment request detail (participants only). */
+    async function getPaymentRequest(paymentRequestId) {
+        const id = requireOrderId(paymentRequestId);
+        return get(`/api/payment-requests/${encodeURIComponent(id)}`, 'get-payment-request', id);
+    }
+    /** Conversations of the signer's wallet. */
+    async function listConversations() {
+        return get(`/api/conversations?userAddress=${encodeURIComponent(signer.address)}`, 'list-conversations', signer.address);
+    }
+    /** Conversation + messages (participants only). */
+    async function getConversationMessages(conversationId) {
+        const id = requireOrderId(conversationId);
+        return get(`/api/conversations/${encodeURIComponent(id)}/messages`, 'get-messages', id);
+    }
+    // ------------------------------------------------------- signed order actions
+    async function post(action, orderId, route, body) {
+        const id = requireOrderId(orderId);
+        const auth = await (0, auth_js_1.signServiceAuth)(signer, action, id);
+        const res = await request(`${base}/api/orders/${encodeURIComponent(id)}/${route}`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ ...body, auth }),
+        });
+        return parse(res, route, id);
+    }
+    /** Buyer: report a confirmed escrow deposit so the order moves out of AwaitingPayment. */
+    async function notifyDeposit(input) {
+        if (!input.txHash)
+            throw new errors_js_1.VeilioSdkError({ code: 'INVALID_INPUT', message: 'txHash is required.' });
+        return post('verify-deposit', input.orderId, 'verify-deposit', {
+            txHash: input.txHash,
+            ...(input.onChainOrderId ? { onChainOrderId: input.onChainOrderId } : {}),
+            buyerAddress: signer.address,
+        });
+    }
+    /** Seller: record the delivery off-chain. Requires the confirmed on-chain `submitDelivery` tx. */
+    async function submit(input) {
+        if (!input.deliveryTxHash || typeof input.deliveryTxHash !== 'string') {
+            throw new errors_js_1.VeilioSdkError({
+                code: 'INVALID_INPUT',
+                message: 'deliveryTxHash (the on-chain submitDelivery transaction) is required.',
+            });
+        }
+        if (!input.description || input.description.trim().length < 5) {
+            throw new errors_js_1.VeilioSdkError({ code: 'INVALID_INPUT', message: 'description must be at least 5 characters.' });
+        }
+        return post('submit', input.orderId, 'submit', {
+            sellerAddress: signer.address,
+            deliveryTxHash: input.deliveryTxHash,
+            description: input.description.trim(),
+            deliverableReferences: input.deliverableReferences ?? [],
+        });
+    }
+    /** Buyer: ask the seller for changes. */
+    async function requestRevision(input) {
+        if (!input.feedback || input.feedback.trim().length < 5) {
+            throw new errors_js_1.VeilioSdkError({ code: 'INVALID_INPUT', message: 'feedback must be at least 5 characters.' });
+        }
+        return post('revision', input.orderId, 'revision', {
+            buyerAddress: signer.address,
+            feedback: input.feedback.trim(),
+        });
+    }
+    /** Buyer: mark the order Completed (call after the on-chain `releaseFunds`). */
+    async function approve(input) {
+        if (!input.releaseTxHash)
+            throw new errors_js_1.VeilioSdkError({ code: 'INVALID_INPUT', message: 'releaseTxHash is required.' });
+        return post('approve', input.orderId, 'approve', {
+            buyerAddress: signer.address,
+            releaseTxHash: input.releaseTxHash,
+        });
+    }
+    /** Buyer (after deadline) or seller: cancel. Funded orders need the on-chain cancel/refund `txHash`. */
+    async function cancel(input) {
+        return post('cancel', input.orderId, 'cancel', {
+            callerAddress: signer.address,
+            ...(input.reason ? { reason: input.reason } : {}),
+            ...(input.txHash ? { txHash: input.txHash } : {}),
+        });
+    }
+    return {
+        apiBaseUrl: base,
+        address: signer.address,
+        // signed, state-changing order actions
+        notifyDeposit,
+        submit,
+        requestRevision,
+        approve,
+        cancel,
+        // session-authenticated reads
+        getSession,
+        getSessionHeaders,
+        getOrder,
+        getPaymentRequest,
+        listConversations,
+        getConversationMessages,
+    };
+}
+//# sourceMappingURL=servicesApi.js.map

package/dist/cjs/servicesApi.js.map

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

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

@@ -0,0 +1,230 @@
+/**
+ * VEILIO Solana Auction Client & Instruction Interface
+ *
+ * Implements client-side PDA derivation, Anchor instruction encoding,
+ * domain-separated sealed commitment calculation, and account deserialization
+ * for the on-chain Solana Devnet Veilio Auction program.
+ */
+import { type SolanaCompiledInstruction } from './registry.js';
+export declare const AUCTION_SEED: Buffer<ArrayBuffer>;
+export declare const BID_COMMITMENT_SEED: Buffer<ArrayBuffer>;
+export declare const COMMITMENT_DOMAIN_TAG: Buffer<ArrayBuffer>;
+/** Global platform config PDA seed: [b"auction_config"] (AuctionConfig account). */
+export declare const AUCTION_CONFIG_SEED: Buffer<ArrayBuffer>;
+/** 8 (discriminator) + 32 admin + 32 reviewer + 1 bump */
+export declare const AUCTION_CONFIG_ACCOUNT_SIZE = 73;
+export declare const DEFAULT_SOLANA_AUCTION_PROGRAM_ID = "5Tw1iJGN1hhyRzepbD5eLoaRoZTEiKcqrh2HoZYhYEta";
+export declare const MAX_ITEM_NAME_LEN = 64;
+export declare const MAX_DESC_LEN = 128;
+export declare const MAX_IMAGE_URI_LEN = 200;
+export declare const MAX_REVIEW_REASON_LEN = 100;
+export declare enum SolanaAuctionState {
+    Created = 0,
+    Bidding = 1,
+    Revealing = 2,
+    Inspection = 3,
+    RefundRequested = 4,
+    UnderReview = 5,
+    Completed = 6,
+    Refunded = 7,
+    Cancelled = 8
+}
+export declare function getSolanaAuctionProgramId(): string;
+/**
+ * Derives the deterministic PDA for an Auction on Solana.
+ * Seeds: [b"auction", auction_id: u64 LE]
+ */
+export declare function findAuctionPda(auctionId: bigint | number, programId?: string): {
+    pda: string;
+    bump: number;
+};
+/**
+ * Derives the global AuctionConfig PDA: [b"auction_config"]. Holds the platform refund reviewer
+ * that the upgraded program uses for create_auction / review_refund.
+ */
+export declare function findAuctionConfigPda(programId?: string): {
+    pda: string;
+    bump: number;
+};
+export interface DecodedAuctionConfig {
+    admin: string;
+    reviewer: string;
+    bump: number;
+}
+/** Decodes the AuctionConfig account (admin, reviewer, bump). */
+export declare function decodeAuctionConfigAccount(data: Buffer | Uint8Array): DecodedAuctionConfig;
+/**
+ * Builds `initialize_config(reviewer)`. 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 createInitializeAuctionConfigInstruction(params: {
+    programId?: string;
+    admin: string;
+    reviewer: string;
+}): SolanaCompiledInstruction;
+/**
+ * Builds `update_config(reviewer, new_admin)`. Signed by the current config admin; `newAdmin`
+ * defaults to `admin` (no hand-over).
+ * accounts: [config (mut, pda), admin (signer)]
+ */
+export declare function createUpdateAuctionConfigInstruction(params: {
+    programId?: string;
+    admin: string;
+    reviewer: string;
+    newAdmin?: string;
+}): SolanaCompiledInstruction;
+/**
+ * Derives the deterministic PDA for a Bidder's Commitment on Solana.
+ * Seeds: [b"bid_commitment", auction_pubkey, bidder_pubkey]
+ */
+export declare function findBidCommitmentPda(auctionPubkey: string, bidderPubkey: string, programId?: string): {
+    pda: string;
+    bump: number;
+};
+/**
+ * Computes domain-separated sealed bid commitment:
+ * SHA-256(b"VEILIO_AUCTION_COMMITMENT_V1" || auction_key || bidder_key || max_bid_le || salt)
+ */
+export declare function computeSealedBidCommitment(params: {
+    auctionPubkey: string;
+    bidderPubkey: string;
+    maxBidLamports: bigint | number;
+    salt: Uint8Array | Buffer;
+}): Buffer;
+export interface DecodedAuctionState {
+    seller: string;
+    reviewer: string;
+    auctionId: bigint;
+    itemName: string;
+    description: string;
+    imageUri: string;
+    startingPrice: bigint;
+    commitEndTime: number;
+    revealEndTime: number;
+    inspectionDuration: number;
+    inspectionEndTime: number;
+    refundRequestedAt: number;
+    state: SolanaAuctionState;
+    highestBidder: string;
+    highestBid: bigint;
+    bidderCount: number;
+    revealedCount: number;
+    evidenceHash: string;
+    reviewReason: string;
+    bump: number;
+}
+export interface DecodedBidCommitment {
+    auction: string;
+    bidder: string;
+    commitment: string;
+    deposit: bigint;
+    maxBid: bigint;
+    revealed: boolean;
+    bump: number;
+}
+/**
+ * Builds `create_auction` instruction.
+ * accounts: [auction (mut, pda), seller (signer, mut), reviewer, system_program, config]
+ *
+ * The upgraded program ignores the `reviewer` account (kept for layout compatibility) and uses
+ * the platform reviewer from the trailing read-only `config` PDA. The pre-upgrade program
+ * stores `reviewer` and ignores `config` as an Anchor remaining account.
+ */
+export declare function createCreateAuctionInstruction(params: {
+    programId?: string;
+    seller: string;
+    reviewer: string;
+    auctionId: bigint | number;
+    itemName: string;
+    description: string;
+    imageUri: string;
+    startingPriceLamports: bigint | number;
+    commitDurationSeconds: number;
+    revealDurationSeconds: number;
+    inspectionDurationSeconds: number;
+}): SolanaCompiledInstruction;
+/**
+ * Builds `commit_bid` instruction.
+ */
+export declare function createCommitBidInstruction(params: {
+    programId?: string;
+    auctionId: bigint | number;
+    bidder: string;
+    commitment: Buffer | Uint8Array;
+    depositLamports: bigint | number;
+}): SolanaCompiledInstruction;
+/**
+ * Builds `reveal_bid` instruction.
+ */
+export declare function createRevealBidInstruction(params: {
+    programId?: string;
+    auctionId: bigint | number;
+    bidder: string;
+    maxBidLamports: bigint | number;
+    salt: Buffer | Uint8Array;
+}): SolanaCompiledInstruction;
+/**
+ * Builds `settle_auction` instruction.
+ */
+export declare function createSettleAuctionInstruction(params: {
+    programId?: string;
+    auctionId: bigint | number;
+}): SolanaCompiledInstruction;
+/**
+ * Builds `accept_dataset` instruction.
+ */
+export declare function createAcceptDatasetInstruction(params: {
+    programId?: string;
+    auctionId: bigint | number;
+    seller: string;
+    winner: string;
+}): SolanaCompiledInstruction;
+/**
+ * Builds `review_refund(approve)`.
+ * accounts: [auction (mut), bid_commitment (mut), seller (mut), reviewer (signer), winner (mut), 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 createReviewRefundInstruction(params: {
+    programId?: string;
+    auctionId: bigint | number;
+    seller: string;
+    reviewer: string;
+    winner: string;
+    approve: boolean;
+}): SolanaCompiledInstruction;
+export declare function createFinalizeInspectionTimeoutInstruction(params: {
+    programId?: string;
+    auctionId: bigint | number;
+    seller: string;
+    winner: string;
+    caller: string;
+}): SolanaCompiledInstruction;
+export declare function createFinalizeRefundTimeoutInstruction(params: {
+    programId?: string;
+    auctionId: bigint | number;
+    winner: string;
+}): SolanaCompiledInstruction;
+export declare function createClaimRefundInstruction(params: {
+    programId?: string;
+    auctionId: bigint | number;
+    bidder: string;
+}): SolanaCompiledInstruction;
+/**
+ * Builds `request_refund` instruction.
+ */
+export declare function createRequestRefundInstruction(params: {
+    programId?: string;
+    auctionId: bigint | number;
+    winner: string;
+    evidenceHash: Buffer | Uint8Array;
+}): SolanaCompiledInstruction;
+/**
+ * Decodes an Anchor `AuctionStateAccount` buffer.
+ */
+export declare function decodeAuctionStateAccount(data: Buffer | Uint8Array): DecodedAuctionState;
+/**
+ * Decodes an Anchor `BidCommitmentAccount` buffer.
+ */
+export declare function decodeBidCommitmentAccount(data: Buffer | Uint8Array): DecodedBidCommitment;
+//# sourceMappingURL=auction.d.ts.map

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

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