clodds 1.1.0

package/dist/payments/x402/solana.js

@@ -0,0 +1,397 @@
+"use strict";
+/**
+ * x402 Solana Payment Signing
+ *
+ * Uses Ed25519 signing for Solana payments
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSolanaWallet = createSolanaWallet;
+exports.signSolanaPayment = signSolanaPayment;
+exports.verifySolanaPayment = verifySolanaPayment;
+exports.verifySolanaPaymentSync = verifySolanaPaymentSync;
+exports.getAssociatedTokenAddress = getAssociatedTokenAddress;
+exports.getAssociatedTokenAddressWithBump = getAssociatedTokenAddressWithBump;
+exports.base58Encode = base58Encode;
+exports.base58Decode = base58Decode;
+exports.signEd25519Sync = signEd25519Sync;
+const crypto_1 = require("crypto");
+const ed25519 = __importStar(require("@noble/ed25519"));
+const sha512_1 = require("@noble/hashes/sha512");
+const logger_1 = require("../../utils/logger");
+// Configure noble/ed25519 to use sha512 (required for sync operations)
+ed25519.etc.sha512Sync = (...messages) => {
+    const combined = new Uint8Array(messages.reduce((acc, m) => acc + m.length, 0));
+    let offset = 0;
+    for (const m of messages) {
+        combined.set(m, offset);
+        offset += m.length;
+    }
+    return (0, sha512_1.sha512)(combined);
+};
+// =============================================================================
+// WALLET UTILITIES
+// =============================================================================
+/**
+ * Decode base58 string to bytes
+ */
+function base58Decode(str) {
+    const ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+    const ALPHABET_MAP = new Map();
+    for (let i = 0; i < ALPHABET.length; i++) {
+        ALPHABET_MAP.set(ALPHABET[i], i);
+    }
+    const bytes = [0];
+    for (const char of str) {
+        const value = ALPHABET_MAP.get(char);
+        if (value === undefined)
+            throw new Error(`Invalid base58 character: ${char}`);
+        let carry = value;
+        for (let j = 0; j < bytes.length; j++) {
+            carry += bytes[j] * 58;
+            bytes[j] = carry & 0xff;
+            carry >>= 8;
+        }
+        while (carry > 0) {
+            bytes.push(carry & 0xff);
+            carry >>= 8;
+        }
+    }
+    // Handle leading zeros
+    for (const char of str) {
+        if (char !== '1')
+            break;
+        bytes.push(0);
+    }
+    return new Uint8Array(bytes.reverse());
+}
+/**
+ * Encode bytes to base58 string
+ */
+function base58Encode(bytes) {
+    const ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+    const digits = [0];
+    for (let i = 0; i < bytes.length; i++) {
+        let carry = bytes[i];
+        for (let j = 0; j < digits.length; j++) {
+            carry += digits[j] << 8;
+            digits[j] = carry % 58;
+            carry = Math.floor(carry / 58);
+        }
+        while (carry > 0) {
+            digits.push(carry % 58);
+            carry = Math.floor(carry / 58);
+        }
+    }
+    // Handle leading zeros
+    let str = '';
+    for (let i = 0; i < bytes.length; i++) {
+        if (bytes[i] !== 0)
+            break;
+        str += '1';
+    }
+    for (let i = digits.length - 1; i >= 0; i--) {
+        str += ALPHABET[digits[i]];
+    }
+    return str;
+}
+/**
+ * Create a Solana wallet from secret key
+ */
+function createSolanaWallet(secretKeyOrBase58) {
+    let secretKey;
+    if (typeof secretKeyOrBase58 === 'string') {
+        // Try base58 first, then raw hex
+        if (secretKeyOrBase58.length === 88 || secretKeyOrBase58.length === 87) {
+            secretKey = base58Decode(secretKeyOrBase58);
+        }
+        else if (secretKeyOrBase58.length === 128) {
+            secretKey = new Uint8Array(Buffer.from(secretKeyOrBase58, 'hex'));
+        }
+        else {
+            // JSON array format
+            try {
+                const arr = JSON.parse(secretKeyOrBase58);
+                secretKey = new Uint8Array(arr);
+            }
+            catch {
+                throw new Error('Invalid Solana secret key format');
+            }
+        }
+    }
+    else {
+        secretKey = secretKeyOrBase58;
+    }
+    // For 64-byte keys, public key is in last 32 bytes
+    // For 32-byte seed, derive public key using Ed25519
+    let publicKeyBytes;
+    if (secretKey.length === 64) {
+        publicKeyBytes = secretKey.slice(32);
+    }
+    else if (secretKey.length === 32) {
+        // Derive public key from seed using Ed25519
+        publicKeyBytes = ed25519.getPublicKey(secretKey);
+    }
+    else {
+        throw new Error(`Invalid secret key length: ${secretKey.length}, expected 32 or 64`);
+    }
+    return {
+        publicKey: base58Encode(publicKeyBytes),
+        secretKey,
+    };
+}
+// =============================================================================
+// ED25519 SIGNING
+// =============================================================================
+/**
+ * Sign a message with Ed25519
+ * Uses @noble/ed25519 for cryptographic signing
+ */
+async function signEd25519(message, secretKey) {
+    // Extract the 32-byte seed from the secret key
+    const seed = secretKey.slice(0, 32);
+    // Sign using Ed25519
+    const signature = await ed25519.signAsync(message, seed);
+    return signature;
+}
+/**
+ * Sign a message with Ed25519 (synchronous version)
+ */
+function signEd25519Sync(message, secretKey) {
+    // Extract the 32-byte seed from the secret key
+    const seed = secretKey.slice(0, 32);
+    // Sign using Ed25519 (sync)
+    const signature = ed25519.sign(message, seed);
+    return signature;
+}
+// =============================================================================
+// PAYMENT SIGNING
+// =============================================================================
+/**
+ * Sign an x402 payment for Solana
+ */
+async function signSolanaPayment(wallet, option) {
+    const nonce = (0, crypto_1.randomBytes)(16).toString('hex');
+    const timestamp = Math.floor(Date.now() / 1000);
+    // Create message to sign
+    const message = JSON.stringify({
+        scheme: option.scheme,
+        network: option.network,
+        asset: option.asset,
+        amount: option.maxAmountRequired,
+        payTo: option.payTo,
+        nonce,
+        timestamp,
+        validUntil: option.validUntil || timestamp + 300,
+    });
+    const messageBytes = new TextEncoder().encode(message);
+    const messageHash = (0, crypto_1.createHash)('sha256').update(messageBytes).digest();
+    // Sign the hash using Ed25519
+    const signatureBytes = await signEd25519(new Uint8Array(messageHash), wallet.secretKey);
+    const signature = base58Encode(signatureBytes);
+    logger_1.logger.debug({ network: option.network, amount: option.maxAmountRequired, payer: wallet.publicKey }, 'x402: Signed Solana payment');
+    return {
+        paymentOption: option,
+        signature,
+        payer: wallet.publicKey,
+        nonce,
+        timestamp,
+    };
+}
+/**
+ * Verify a Solana payment signature
+ */
+async function verifySolanaPayment(payload) {
+    try {
+        // Decode the signature and public key from base58
+        const signatureBytes = base58Decode(payload.signature);
+        const publicKeyBytes = base58Decode(payload.payer);
+        // Validate lengths
+        if (signatureBytes.length !== 64) {
+            logger_1.logger.debug({ length: signatureBytes.length }, 'Invalid signature length');
+            return false;
+        }
+        if (publicKeyBytes.length !== 32) {
+            logger_1.logger.debug({ length: publicKeyBytes.length }, 'Invalid public key length');
+            return false;
+        }
+        // Reconstruct the message that was signed
+        const message = JSON.stringify({
+            scheme: payload.paymentOption.scheme,
+            network: payload.paymentOption.network,
+            asset: payload.paymentOption.asset,
+            amount: payload.paymentOption.maxAmountRequired,
+            payTo: payload.paymentOption.payTo,
+            nonce: payload.nonce,
+            timestamp: payload.timestamp,
+            validUntil: payload.paymentOption.validUntil || payload.timestamp + 300,
+        });
+        const messageBytes = new TextEncoder().encode(message);
+        const messageHash = (0, crypto_1.createHash)('sha256').update(messageBytes).digest();
+        // Verify the signature using Ed25519
+        const isValid = await ed25519.verifyAsync(signatureBytes, new Uint8Array(messageHash), publicKeyBytes);
+        return isValid;
+    }
+    catch (error) {
+        logger_1.logger.debug({ error }, 'Failed to verify Solana payment signature');
+        return false;
+    }
+}
+/**
+ * Verify a Solana payment signature (synchronous version)
+ */
+function verifySolanaPaymentSync(payload) {
+    try {
+        const signatureBytes = base58Decode(payload.signature);
+        const publicKeyBytes = base58Decode(payload.payer);
+        if (signatureBytes.length !== 64 || publicKeyBytes.length !== 32) {
+            return false;
+        }
+        const message = JSON.stringify({
+            scheme: payload.paymentOption.scheme,
+            network: payload.paymentOption.network,
+            asset: payload.paymentOption.asset,
+            amount: payload.paymentOption.maxAmountRequired,
+            payTo: payload.paymentOption.payTo,
+            nonce: payload.nonce,
+            timestamp: payload.timestamp,
+            validUntil: payload.paymentOption.validUntil || payload.timestamp + 300,
+        });
+        const messageBytes = new TextEncoder().encode(message);
+        const messageHash = (0, crypto_1.createHash)('sha256').update(messageBytes).digest();
+        return ed25519.verify(signatureBytes, new Uint8Array(messageHash), publicKeyBytes);
+    }
+    catch {
+        return false;
+    }
+}
+// =============================================================================
+// SPL TOKEN UTILITIES
+// =============================================================================
+// Solana program IDs
+const TOKEN_PROGRAM_ID = 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA';
+const ASSOCIATED_TOKEN_PROGRAM_ID = 'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL';
+/**
+ * Find Program Derived Address (PDA)
+ * Implements Solana's findProgramAddress algorithm
+ */
+function findProgramAddress(seeds, programId) {
+    // Try bump seeds from 255 down to 0
+    for (let bump = 255; bump >= 0; bump--) {
+        const seedsWithBump = [...seeds, new Uint8Array([bump])];
+        // Concatenate all seeds
+        const totalLength = seedsWithBump.reduce((acc, s) => acc + s.length, 0) + programId.length + 1;
+        const buffer = new Uint8Array(totalLength);
+        let offset = 0;
+        for (const seed of seedsWithBump) {
+            buffer.set(seed, offset);
+            offset += seed.length;
+        }
+        buffer.set(programId, offset);
+        offset += programId.length;
+        // Add "ProgramDerivedAddress" marker
+        const marker = new TextEncoder().encode('ProgramDerivedAddress');
+        // Create final buffer with marker
+        const finalBuffer = new Uint8Array(buffer.length + marker.length);
+        finalBuffer.set(buffer, 0);
+        finalBuffer.set(marker, buffer.length);
+        // SHA256 hash
+        const hash = (0, crypto_1.createHash)('sha256').update(finalBuffer).digest();
+        // Check if it's a valid PDA (off the ed25519 curve)
+        // A point is on the curve if the hash can be decoded as a valid public key
+        // For simplicity, we assume any hash with specific properties is valid
+        // In production, would check if point is on curve using ed25519 library
+        if (isOffCurve(hash)) {
+            return { address: new Uint8Array(hash), bump };
+        }
+    }
+    return null;
+}
+/**
+ * Check if a 32-byte value is off the ed25519 curve (valid PDA)
+ * Uses Ed25519 point validation - a valid PDA must NOT be a valid public key
+ */
+function isOffCurve(bytes) {
+    try {
+        // Attempt to use this as a public key point
+        // If it's a valid Ed25519 point (on curve), this will succeed
+        // For PDAs, we want points that are NOT on the curve
+        const point = ed25519.ExtendedPoint.fromHex(bytes);
+        // If we get here, the point is ON the curve, so NOT a valid PDA
+        return false;
+    }
+    catch {
+        // Error means the point is NOT on the curve - valid for PDA
+        return true;
+    }
+}
+/**
+ * Get associated token address for SPL tokens
+ * Derives the ATA using the standard SPL Token PDA
+ */
+function getAssociatedTokenAddress(walletAddress, mintAddress) {
+    // Decode addresses from base58
+    const walletBytes = base58Decode(walletAddress);
+    const mintBytes = base58Decode(mintAddress);
+    const tokenProgramBytes = base58Decode(TOKEN_PROGRAM_ID);
+    const ataProgramBytes = base58Decode(ASSOCIATED_TOKEN_PROGRAM_ID);
+    // Seeds for ATA derivation: [wallet, TOKEN_PROGRAM_ID, mint]
+    const seeds = [walletBytes, tokenProgramBytes, mintBytes];
+    // Find PDA
+    const result = findProgramAddress(seeds, ataProgramBytes);
+    if (!result) {
+        throw new Error('Failed to derive associated token address');
+    }
+    return base58Encode(result.address);
+}
+/**
+ * Get associated token address with bump seed
+ */
+function getAssociatedTokenAddressWithBump(walletAddress, mintAddress) {
+    const walletBytes = base58Decode(walletAddress);
+    const mintBytes = base58Decode(mintAddress);
+    const tokenProgramBytes = base58Decode(TOKEN_PROGRAM_ID);
+    const ataProgramBytes = base58Decode(ASSOCIATED_TOKEN_PROGRAM_ID);
+    const seeds = [walletBytes, tokenProgramBytes, mintBytes];
+    const result = findProgramAddress(seeds, ataProgramBytes);
+    if (!result) {
+        throw new Error('Failed to derive associated token address');
+    }
+    return {
+        address: base58Encode(result.address),
+        bump: result.bump,
+    };
+}
+//# sourceMappingURL=solana.js.map

package/dist/payments/x402/solana.js.map

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

package/dist/percolator/accounts.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Percolator account specifications for building instruction account metas.
+ * Adapted from percolator-cli/src/abi/accounts.ts — subset needed for trading.
+ */
+import { PublicKey, AccountMeta } from '@solana/web3.js';
+export interface AccountSpec {
+    name: string;
+    signer: boolean;
+    writable: boolean;
+}
+export declare const ACCOUNTS_INIT_USER: readonly AccountSpec[];
+export declare const ACCOUNTS_DEPOSIT_COLLATERAL: readonly AccountSpec[];
+export declare const ACCOUNTS_WITHDRAW_COLLATERAL: readonly AccountSpec[];
+export declare const ACCOUNTS_KEEPER_CRANK: readonly AccountSpec[];
+export declare const ACCOUNTS_TRADE_CPI: readonly AccountSpec[];
+export declare function buildAccountMetas(spec: readonly AccountSpec[], keys: PublicKey[]): AccountMeta[];
+export declare const WELL_KNOWN: {
+    readonly tokenProgram: PublicKey;
+    readonly clock: PublicKey;
+    readonly systemProgram: PublicKey;
+};

package/dist/percolator/accounts.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * Percolator account specifications for building instruction account metas.
+ * Adapted from percolator-cli/src/abi/accounts.ts — subset needed for trading.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WELL_KNOWN = exports.ACCOUNTS_TRADE_CPI = exports.ACCOUNTS_KEEPER_CRANK = exports.ACCOUNTS_WITHDRAW_COLLATERAL = exports.ACCOUNTS_DEPOSIT_COLLATERAL = exports.ACCOUNTS_INIT_USER = void 0;
+exports.buildAccountMetas = buildAccountMetas;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+// ============================================================================
+// Account orderings (match Rust processor)
+// ============================================================================
+exports.ACCOUNTS_INIT_USER = [
+    { name: 'user', signer: true, writable: false },
+    { name: 'slab', signer: false, writable: true },
+    { name: 'userAta', signer: false, writable: true },
+    { name: 'vault', signer: false, writable: true },
+    { name: 'tokenProgram', signer: false, writable: false },
+];
+exports.ACCOUNTS_DEPOSIT_COLLATERAL = [
+    { name: 'user', signer: true, writable: false },
+    { name: 'slab', signer: false, writable: true },
+    { name: 'userAta', signer: false, writable: true },
+    { name: 'vault', signer: false, writable: true },
+    { name: 'tokenProgram', signer: false, writable: false },
+    { name: 'clock', signer: false, writable: false },
+];
+exports.ACCOUNTS_WITHDRAW_COLLATERAL = [
+    { name: 'user', signer: true, writable: false },
+    { name: 'slab', signer: false, writable: true },
+    { name: 'vault', signer: false, writable: true },
+    { name: 'userAta', signer: false, writable: true },
+    { name: 'vaultPda', signer: false, writable: false },
+    { name: 'tokenProgram', signer: false, writable: false },
+    { name: 'clock', signer: false, writable: false },
+    { name: 'oracleIdx', signer: false, writable: false },
+];
+exports.ACCOUNTS_KEEPER_CRANK = [
+    { name: 'caller', signer: true, writable: false },
+    { name: 'slab', signer: false, writable: true },
+    { name: 'clock', signer: false, writable: false },
+    { name: 'oracle', signer: false, writable: false },
+];
+exports.ACCOUNTS_TRADE_CPI = [
+    { name: 'user', signer: true, writable: false },
+    { name: 'lpOwner', signer: false, writable: false },
+    { name: 'slab', signer: false, writable: true },
+    { name: 'clock', signer: false, writable: false },
+    { name: 'oracle', signer: false, writable: false },
+    { name: 'matcherProg', signer: false, writable: false },
+    { name: 'matcherCtx', signer: false, writable: true },
+    { name: 'lpPda', signer: false, writable: false },
+];
+// ============================================================================
+// Account meta builder
+// ============================================================================
+function buildAccountMetas(spec, keys) {
+    if (keys.length !== spec.length) {
+        throw new Error(`Account count mismatch: expected ${spec.length}, got ${keys.length}`);
+    }
+    return spec.map((s, i) => ({
+        pubkey: keys[i],
+        isSigner: s.signer,
+        isWritable: s.writable,
+    }));
+}
+// ============================================================================
+// Well-known keys
+// ============================================================================
+exports.WELL_KNOWN = {
+    tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+    clock: web3_js_1.SYSVAR_CLOCK_PUBKEY,
+    systemProgram: web3_js_1.SystemProgram.programId,
+};
+//# sourceMappingURL=accounts.js.map

package/dist/percolator/accounts.js.map

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

package/dist/percolator/encode.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Percolator buffer encoding helpers.
+ * Adapted from percolator-cli/src/abi/encode.ts
+ */
+import { PublicKey } from '@solana/web3.js';
+export declare function encU8(val: number): Buffer;
+export declare function encU16(val: number): Buffer;
+export declare function encU32(val: number): Buffer;
+export declare function encU64(val: bigint | string): Buffer;
+export declare function encI64(val: bigint | string): Buffer;
+export declare function encU128(val: bigint | string): Buffer;
+export declare function encI128(val: bigint | string): Buffer;
+export declare function encPubkey(val: PublicKey | string): Buffer;
+export declare function encBool(val: boolean): Buffer;

package/dist/percolator/encode.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * Percolator buffer encoding helpers.
+ * Adapted from percolator-cli/src/abi/encode.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encU8 = encU8;
+exports.encU16 = encU16;
+exports.encU32 = encU32;
+exports.encU64 = encU64;
+exports.encI64 = encI64;
+exports.encU128 = encU128;
+exports.encI128 = encI128;
+exports.encPubkey = encPubkey;
+exports.encBool = encBool;
+const web3_js_1 = require("@solana/web3.js");
+function encU8(val) {
+    const buf = Buffer.alloc(1);
+    buf.writeUInt8(val, 0);
+    return buf;
+}
+function encU16(val) {
+    const buf = Buffer.alloc(2);
+    buf.writeUInt16LE(val, 0);
+    return buf;
+}
+function encU32(val) {
+    const buf = Buffer.alloc(4);
+    buf.writeUInt32LE(val, 0);
+    return buf;
+}
+function encU64(val) {
+    const n = typeof val === 'string' ? BigInt(val) : val;
+    if (n < 0n)
+        throw new Error('encU64: value must be non-negative');
+    if (n > 0xffffffffffffffffn)
+        throw new Error('encU64: value exceeds u64 max');
+    const buf = Buffer.alloc(8);
+    buf.writeBigUInt64LE(n, 0);
+    return buf;
+}
+function encI64(val) {
+    const n = typeof val === 'string' ? BigInt(val) : val;
+    const min = -(1n << 63n);
+    const max = (1n << 63n) - 1n;
+    if (n < min || n > max)
+        throw new Error('encI64: value out of range');
+    const buf = Buffer.alloc(8);
+    buf.writeBigInt64LE(n, 0);
+    return buf;
+}
+function encU128(val) {
+    const n = typeof val === 'string' ? BigInt(val) : val;
+    if (n < 0n)
+        throw new Error('encU128: value must be non-negative');
+    const max = (1n << 128n) - 1n;
+    if (n > max)
+        throw new Error('encU128: value exceeds u128 max');
+    const buf = Buffer.alloc(16);
+    const lo = n & 0xffffffffffffffffn;
+    const hi = n >> 64n;
+    buf.writeBigUInt64LE(lo, 0);
+    buf.writeBigUInt64LE(hi, 8);
+    return buf;
+}
+function encI128(val) {
+    const n = typeof val === 'string' ? BigInt(val) : val;
+    const min = -(1n << 127n);
+    const max = (1n << 127n) - 1n;
+    if (n < min || n > max)
+        throw new Error('encI128: value out of range');
+    let unsigned = n;
+    if (n < 0n) {
+        unsigned = (1n << 128n) + n;
+    }
+    const buf = Buffer.alloc(16);
+    const lo = unsigned & 0xffffffffffffffffn;
+    const hi = unsigned >> 64n;
+    buf.writeBigUInt64LE(lo, 0);
+    buf.writeBigUInt64LE(hi, 8);
+    return buf;
+}
+function encPubkey(val) {
+    const pk = typeof val === 'string' ? new web3_js_1.PublicKey(val) : val;
+    return Buffer.from(pk.toBytes());
+}
+function encBool(val) {
+    return encU8(val ? 1 : 0);
+}
+//# sourceMappingURL=encode.js.map

package/dist/percolator/encode.js.map

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

package/dist/percolator/execution.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Percolator execution service — wraps trade-cpi as a partial ExecutionService adapter.
+ */
+import type { PercolatorConfig, PercolatorPosition } from './types.js';
+export interface PercolatorOrderRequest {
+    /** Positive size = long, negative = short (in base units) */
+    size: bigint;
+    /** LP index to trade against (default: config.lpIndex ?? 0) */
+    lpIndex?: number;
+}
+export interface PercolatorOrderResult {
+    success: boolean;
+    signature?: string;
+    error?: string;
+    slot?: number;
+}
+export interface PercolatorExecutionService {
+    marketBuy(req: {
+        size: number;
+    }): Promise<PercolatorOrderResult>;
+    marketSell(req: {
+        size: number;
+    }): Promise<PercolatorOrderResult>;
+    deposit(amount: bigint): Promise<PercolatorOrderResult>;
+    withdraw(amount: bigint): Promise<PercolatorOrderResult>;
+    getPositions(): Promise<PercolatorPosition[]>;
+    getUserIndex(): Promise<number | null>;
+}
+export declare function createPercolatorExecution(config: PercolatorConfig): PercolatorExecutionService;