clodds 1.1.0

package/dist/percolator/execution.js

@@ -0,0 +1,239 @@
+"use strict";
+/**
+ * Percolator execution service — wraps trade-cpi as a partial ExecutionService adapter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPercolatorExecution = createPercolatorExecution;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+const logger_js_1 = require("../utils/logger.js");
+const ASSOCIATED_TOKEN_PROGRAM_ID = new web3_js_1.PublicKey('ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL');
+function deriveAta(owner, mint) {
+    const [ata] = web3_js_1.PublicKey.findProgramAddressSync([owner.toBuffer(), spl_token_1.TOKEN_PROGRAM_ID.toBuffer(), mint.toBuffer()], ASSOCIATED_TOKEN_PROGRAM_ID);
+    return ata;
+}
+const wallet_js_1 = require("../solana/wallet.js");
+const types_js_1 = require("./types.js");
+const slab_js_1 = require("./slab.js");
+const accounts_js_1 = require("./accounts.js");
+const instructions_js_1 = require("./instructions.js");
+const pda_js_1 = require("./pda.js");
+const tx_js_1 = require("./tx.js");
+function createPercolatorExecution(config) {
+    const rpcUrl = config.rpcUrl ?? process.env.SOLANA_RPC_URL ?? types_js_1.DEFAULT_RPC_URL;
+    const programId = new web3_js_1.PublicKey(config.programId ?? '2SSnp35m7FQ7cRLNKGdW5UzjYFF6RBUNq7d3m5mqNByp');
+    const slabAddress = config.slabAddress ? new web3_js_1.PublicKey(config.slabAddress) : null;
+    const matcherProgram = config.matcherProgram ? new web3_js_1.PublicKey(config.matcherProgram) : null;
+    const matcherContext = config.matcherContext ? new web3_js_1.PublicKey(config.matcherContext) : null;
+    const oracleAddress = config.oracleAddress ? new web3_js_1.PublicKey(config.oracleAddress) : null;
+    const defaultLpIndex = config.lpIndex ?? 0;
+    const dryRun = config.dryRun ?? true;
+    let connection = null;
+    let keypair = null;
+    function getConnection() {
+        if (!connection) {
+            connection = new web3_js_1.Connection(rpcUrl, 'confirmed');
+        }
+        return connection;
+    }
+    function getKeypair() {
+        if (!keypair) {
+            keypair = (0, wallet_js_1.loadSolanaKeypair)({ rpcUrl });
+        }
+        return keypair;
+    }
+    async function findUserIndex(data, owner) {
+        const allAccounts = (0, slab_js_1.parseAllAccounts)(data);
+        for (const { idx, account } of allAccounts) {
+            if (account.kind === slab_js_1.AccountKind.User && account.owner.equals(owner)) {
+                return idx;
+            }
+        }
+        return null;
+    }
+    async function executeTrade(size, lpIndex) {
+        if (!slabAddress)
+            return { success: false, error: 'slabAddress not configured' };
+        if (!matcherProgram)
+            return { success: false, error: 'matcherProgram not configured' };
+        if (!matcherContext)
+            return { success: false, error: 'matcherContext not configured' };
+        if (!oracleAddress)
+            return { success: false, error: 'oracleAddress not configured' };
+        try {
+            const conn = getConnection();
+            const kp = getKeypair();
+            const lpIdx = lpIndex ?? defaultLpIndex;
+            // Fetch slab to find user index and LP owner
+            const data = await (0, slab_js_1.fetchSlab)(conn, slabAddress);
+            const userIdx = await findUserIndex(data, kp.publicKey);
+            if (userIdx === null) {
+                return { success: false, error: 'No user account found on slab. Run init-user first.' };
+            }
+            // Find LP owner from slab
+            const allAccounts = (0, slab_js_1.parseAllAccounts)(data);
+            const lpAccount = allAccounts.find(a => a.idx === lpIdx && a.account.kind === slab_js_1.AccountKind.LP);
+            if (!lpAccount) {
+                return { success: false, error: `LP account at index ${lpIdx} not found` };
+            }
+            const lpOwner = lpAccount.account.owner;
+            // Derive LP PDA
+            const [lpPda] = (0, pda_js_1.deriveLpPda)(programId, slabAddress, lpIdx);
+            // Encode instruction
+            const ixData = (0, instructions_js_1.encodeTradeCpi)({ lpIdx, userIdx, size });
+            // Build account metas
+            const keys = (0, accounts_js_1.buildAccountMetas)(accounts_js_1.ACCOUNTS_TRADE_CPI, [
+                kp.publicKey, // user (signer)
+                lpOwner, // lpOwner
+                slabAddress, // slab (writable)
+                accounts_js_1.WELL_KNOWN.clock, // clock
+                oracleAddress, // oracle
+                matcherProgram, // matcherProg
+                matcherContext, // matcherCtx (writable)
+                lpPda, // lpPda
+            ]);
+            // Build and send
+            const ix = (0, tx_js_1.buildIx)({ programId, keys, data: ixData });
+            const result = await (0, tx_js_1.simulateOrSend)({
+                connection: conn,
+                ix,
+                signers: [kp],
+                simulate: dryRun,
+            });
+            if (result.err) {
+                logger_js_1.logger.warn({ err: result.err, sig: result.signature }, 'Percolator trade failed');
+                return { success: false, error: result.err, signature: result.signature };
+            }
+            logger_js_1.logger.info({
+                sig: result.signature,
+                slot: result.slot,
+                size: size.toString(),
+                lpIdx,
+            }, 'Percolator trade executed');
+            return { success: true, signature: result.signature, slot: result.slot };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger_js_1.logger.error({ err: msg }, 'Percolator trade error');
+            return { success: false, error: msg };
+        }
+    }
+    return {
+        async marketBuy(req) {
+            // Convert USD size to base units (1e6 for USDC)
+            const sizeUnits = BigInt(Math.round(req.size * 1_000_000));
+            return executeTrade(sizeUnits);
+        },
+        async marketSell(req) {
+            const sizeUnits = BigInt(Math.round(req.size * 1_000_000));
+            return executeTrade(-sizeUnits);
+        },
+        async deposit(amount) {
+            if (!slabAddress)
+                return { success: false, error: 'slabAddress not configured' };
+            try {
+                const conn = getConnection();
+                const kp = getKeypair();
+                const data = await (0, slab_js_1.fetchSlab)(conn, slabAddress);
+                const userIdx = await findUserIndex(data, kp.publicKey);
+                if (userIdx === null)
+                    return { success: false, error: 'No user account found' };
+                const mktConfig = (0, slab_js_1.parseConfig)(data);
+                const userAta = deriveAta(kp.publicKey, mktConfig.collateralMint);
+                const ixData = (0, instructions_js_1.encodeDepositCollateral)({ userIdx, amount });
+                const keys = (0, accounts_js_1.buildAccountMetas)(accounts_js_1.ACCOUNTS_DEPOSIT_COLLATERAL, [
+                    kp.publicKey,
+                    slabAddress,
+                    userAta,
+                    mktConfig.vaultPubkey,
+                    accounts_js_1.WELL_KNOWN.tokenProgram,
+                    accounts_js_1.WELL_KNOWN.clock,
+                ]);
+                const ix = (0, tx_js_1.buildIx)({ programId, keys, data: ixData });
+                const result = await (0, tx_js_1.simulateOrSend)({ connection: conn, ix, signers: [kp], simulate: dryRun });
+                if (result.err)
+                    return { success: false, error: result.err };
+                return { success: true, signature: result.signature, slot: result.slot };
+            }
+            catch (err) {
+                return { success: false, error: err instanceof Error ? err.message : String(err) };
+            }
+        },
+        async withdraw(amount) {
+            if (!slabAddress || !oracleAddress)
+                return { success: false, error: 'slabAddress/oracleAddress not configured' };
+            try {
+                const conn = getConnection();
+                const kp = getKeypair();
+                const data = await (0, slab_js_1.fetchSlab)(conn, slabAddress);
+                const userIdx = await findUserIndex(data, kp.publicKey);
+                if (userIdx === null)
+                    return { success: false, error: 'No user account found' };
+                const mktConfig = (0, slab_js_1.parseConfig)(data);
+                const userAta = deriveAta(kp.publicKey, mktConfig.collateralMint);
+                const [vaultPda] = (0, pda_js_1.deriveVaultAuthority)(programId, slabAddress);
+                const ixData = (0, instructions_js_1.encodeWithdrawCollateral)({ userIdx, amount });
+                const keys = (0, accounts_js_1.buildAccountMetas)(accounts_js_1.ACCOUNTS_WITHDRAW_COLLATERAL, [
+                    kp.publicKey,
+                    slabAddress,
+                    mktConfig.vaultPubkey,
+                    userAta,
+                    vaultPda,
+                    accounts_js_1.WELL_KNOWN.tokenProgram,
+                    accounts_js_1.WELL_KNOWN.clock,
+                    oracleAddress,
+                ]);
+                const ix = (0, tx_js_1.buildIx)({ programId, keys, data: ixData });
+                const result = await (0, tx_js_1.simulateOrSend)({ connection: conn, ix, signers: [kp], simulate: dryRun });
+                if (result.err)
+                    return { success: false, error: result.err };
+                return { success: true, signature: result.signature, slot: result.slot };
+            }
+            catch (err) {
+                return { success: false, error: err instanceof Error ? err.message : String(err) };
+            }
+        },
+        async getPositions() {
+            if (!slabAddress)
+                return [];
+            try {
+                const conn = getConnection();
+                const kp = getKeypair();
+                const data = await (0, slab_js_1.fetchSlab)(conn, slabAddress);
+                const allAccounts = (0, slab_js_1.parseAllAccounts)(data);
+                return allAccounts
+                    .filter(({ account }) => account.kind === slab_js_1.AccountKind.User &&
+                    account.positionSize !== 0n &&
+                    account.owner.equals(kp.publicKey))
+                    .map(({ idx, account }) => ({
+                    accountIndex: idx,
+                    capital: account.capital,
+                    positionSize: account.positionSize,
+                    entryPrice: account.entryPrice,
+                    pnl: account.pnl,
+                    fundingIndex: account.fundingIndex,
+                    owner: account.owner,
+                }));
+            }
+            catch (err) {
+                logger_js_1.logger.warn({ err: err instanceof Error ? err.message : String(err) }, 'Percolator getPositions failed');
+                return [];
+            }
+        },
+        async getUserIndex() {
+            if (!slabAddress)
+                return null;
+            try {
+                const conn = getConnection();
+                const kp = getKeypair();
+                const data = await (0, slab_js_1.fetchSlab)(conn, slabAddress);
+                return findUserIndex(data, kp.publicKey);
+            }
+            catch (err) {
+                logger_js_1.logger.warn({ err: err instanceof Error ? err.message : String(err) }, 'Percolator getUserIndex failed');
+                return null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=execution.js.map

package/dist/percolator/execution.js.map

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

package/dist/percolator/feed.d.ts

@@ -0,0 +1,15 @@
+/**
+ * PercolatorFeed — polls slab account for price, orderbook, and position data.
+ * Emits 'price' and 'orderbook' events compatible with FeedManager.
+ */
+import { EventEmitter } from 'events';
+import { PublicKey } from '@solana/web3.js';
+import type { PercolatorConfig, PercolatorMarketState, PercolatorPosition } from './types.js';
+export interface PercolatorFeed extends EventEmitter {
+    connect(): Promise<void>;
+    disconnect(): void;
+    getMarketState(): PercolatorMarketState | null;
+    getPositions(owner?: PublicKey): PercolatorPosition[];
+    getPrice(): number | null;
+}
+export declare function createPercolatorFeed(config: PercolatorConfig): PercolatorFeed;

package/dist/percolator/feed.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * PercolatorFeed — polls slab account for price, orderbook, and position data.
+ * Emits 'price' and 'orderbook' events compatible with FeedManager.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPercolatorFeed = createPercolatorFeed;
+const events_1 = require("events");
+const web3_js_1 = require("@solana/web3.js");
+const logger_js_1 = require("../utils/logger.js");
+const types_js_1 = require("./types.js");
+const slab_js_1 = require("./slab.js");
+function createPercolatorFeed(config) {
+    const feed = new events_1.EventEmitter();
+    const pollInterval = config.pollIntervalMs ?? 2000;
+    const rpcUrl = config.rpcUrl ?? process.env.SOLANA_RPC_URL ?? types_js_1.DEFAULT_RPC_URL;
+    const configSpreadBps = BigInt(config.spreadBps ?? 50);
+    const POLL_TIMEOUT_MS = 10_000;
+    let connection = null;
+    let slabPubkey = null;
+    let timer = null;
+    let lastState = null;
+    let lastSlabData = null;
+    let lastPrice = null;
+    async function poll() {
+        if (!connection || !slabPubkey)
+            return;
+        try {
+            const data = await Promise.race([
+                (0, slab_js_1.fetchSlab)(connection, slabPubkey),
+                new Promise((_, reject) => setTimeout(() => reject(new Error('RPC poll timeout')), POLL_TIMEOUT_MS)),
+            ]);
+            lastSlabData = data;
+            const header = (0, slab_js_1.parseHeader)(data);
+            const mktConfig = (0, slab_js_1.parseConfig)(data);
+            const engine = (0, slab_js_1.parseEngine)(data);
+            // Oracle price: use authority_price_e6 if set, else lastEffectivePriceE6
+            const oraclePriceE6 = mktConfig.authorityPriceE6 > 0n
+                ? mktConfig.authorityPriceE6
+                : mktConfig.lastEffectivePriceE6;
+            const oraclePriceUsd = Number(oraclePriceE6) / 1_000_000;
+            // Find best LP bid/ask by scanning LP accounts
+            const allAccounts = (0, slab_js_1.parseAllAccounts)(data);
+            let bestBid = null;
+            let bestAsk = null;
+            for (const { idx, account } of allAccounts) {
+                if (account.kind !== slab_js_1.AccountKind.LP)
+                    continue;
+                if (account.capital === 0n)
+                    continue;
+                // Passive matcher LP: quote = oracle ± spread
+                const bidPriceE6 = oraclePriceE6 - (oraclePriceE6 * configSpreadBps / 10000n);
+                const askPriceE6 = oraclePriceE6 + (oraclePriceE6 * configSpreadBps / 10000n);
+                if (!bestBid || bidPriceE6 > bestBid.price) {
+                    bestBid = { lpIndex: idx, price: bidPriceE6, priceUsd: Number(bidPriceE6) / 1_000_000 };
+                }
+                if (!bestAsk || askPriceE6 < bestAsk.price) {
+                    bestAsk = { lpIndex: idx, price: askPriceE6, priceUsd: Number(askPriceE6) / 1_000_000 };
+                }
+            }
+            const spreadBps = bestBid && bestAsk
+                ? Number((bestAsk.price - bestBid.price) * 10000n / oraclePriceE6)
+                : 0;
+            const state = {
+                oraclePrice: oraclePriceE6,
+                oraclePriceUsd,
+                oracleDecimals: 6,
+                totalOpenInterest: engine.totalOpenInterest,
+                vault: engine.vault,
+                insuranceFund: engine.insuranceFund.balance,
+                fundingRate: engine.fundingRateBpsPerSlotLast,
+                bestBid,
+                bestAsk,
+                spreadBps,
+                lastCrankSlot: engine.lastCrankSlot,
+            };
+            lastState = state;
+            // Emit price event if changed
+            if (lastPrice !== oraclePriceUsd) {
+                lastPrice = oraclePriceUsd;
+                feed.emit('price', {
+                    platform: 'percolator',
+                    marketId: slabPubkey.toBase58(),
+                    outcomeId: 'perp',
+                    price: oraclePriceUsd,
+                    timestamp: Date.now(),
+                });
+            }
+            // Emit orderbook event
+            if (bestBid && bestAsk) {
+                feed.emit('orderbook', {
+                    platform: 'percolator',
+                    marketId: slabPubkey.toBase58(),
+                    outcomeId: 'perp',
+                    bids: [[bestBid.priceUsd, Number(engine.vault) / 1_000_000]],
+                    asks: [[bestAsk.priceUsd, Number(engine.vault) / 1_000_000]],
+                    timestamp: Date.now(),
+                });
+            }
+        }
+        catch (err) {
+            logger_js_1.logger.warn({ err }, 'Percolator feed poll error');
+        }
+    }
+    feed.connect = async () => {
+        if (!config.slabAddress) {
+            throw new Error('Percolator: slabAddress required');
+        }
+        connection = new web3_js_1.Connection(rpcUrl, 'confirmed');
+        slabPubkey = new web3_js_1.PublicKey(config.slabAddress);
+        logger_js_1.logger.info({
+            slab: config.slabAddress,
+            rpc: rpcUrl,
+            pollMs: pollInterval,
+        }, 'Percolator feed connecting');
+        // Initial poll
+        await poll();
+        // Start polling
+        timer = setInterval(poll, pollInterval);
+    };
+    feed.disconnect = () => {
+        if (timer) {
+            clearInterval(timer);
+            timer = null;
+        }
+        connection = null;
+        lastState = null;
+        lastSlabData = null;
+        lastPrice = null;
+        logger_js_1.logger.info('Percolator feed disconnected');
+    };
+    feed.getMarketState = () => lastState;
+    feed.getPositions = (owner) => {
+        if (!lastSlabData)
+            return [];
+        const allAccounts = (0, slab_js_1.parseAllAccounts)(lastSlabData);
+        return allAccounts
+            .filter(({ account }) => {
+            if (account.kind !== slab_js_1.AccountKind.User)
+                return false;
+            if (account.positionSize === 0n)
+                return false;
+            if (owner && !account.owner.equals(owner))
+                return false;
+            return true;
+        })
+            .map(({ idx, account }) => ({
+            accountIndex: idx,
+            capital: account.capital,
+            positionSize: account.positionSize,
+            entryPrice: account.entryPrice,
+            pnl: account.pnl,
+            fundingIndex: account.fundingIndex,
+            owner: account.owner,
+        }));
+    };
+    feed.getPrice = () => lastPrice;
+    return feed;
+}
+//# sourceMappingURL=feed.js.map

package/dist/percolator/feed.js.map

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

package/dist/percolator/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Percolator module — on-chain Solana perpetual futures.
+ * Factory + re-exports.
+ */
+export type { PercolatorConfig, PercolatorMarketState, PercolatorPosition } from './types.js';
+export type { PercolatorFeed } from './feed.js';
+export type { PercolatorExecutionService, PercolatorOrderResult } from './execution.js';
+export type { PercolatorKeeper } from './keeper.js';
+export { createPercolatorFeed } from './feed.js';
+export { createPercolatorExecution } from './execution.js';
+export { createPercolatorKeeper } from './keeper.js';
+import type { PercolatorConfig } from './types.js';
+import type { PercolatorFeed } from './feed.js';
+import type { PercolatorExecutionService } from './execution.js';
+import type { PercolatorKeeper } from './keeper.js';
+export declare function createPercolatorService(config: PercolatorConfig): {
+    feed: PercolatorFeed;
+    execution: PercolatorExecutionService;
+    keeper: PercolatorKeeper | null;
+};

package/dist/percolator/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Percolator module — on-chain Solana perpetual futures.
+ * Factory + re-exports.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPercolatorKeeper = exports.createPercolatorExecution = exports.createPercolatorFeed = void 0;
+exports.createPercolatorService = createPercolatorService;
+var feed_js_1 = require("./feed.js");
+Object.defineProperty(exports, "createPercolatorFeed", { enumerable: true, get: function () { return feed_js_1.createPercolatorFeed; } });
+var execution_js_1 = require("./execution.js");
+Object.defineProperty(exports, "createPercolatorExecution", { enumerable: true, get: function () { return execution_js_1.createPercolatorExecution; } });
+var keeper_js_1 = require("./keeper.js");
+Object.defineProperty(exports, "createPercolatorKeeper", { enumerable: true, get: function () { return keeper_js_1.createPercolatorKeeper; } });
+const feed_js_2 = require("./feed.js");
+const execution_js_2 = require("./execution.js");
+const keeper_js_2 = require("./keeper.js");
+function createPercolatorService(config) {
+    const feed = (0, feed_js_2.createPercolatorFeed)(config);
+    const execution = (0, execution_js_2.createPercolatorExecution)(config);
+    const keeper = config.keeperEnabled ? (0, keeper_js_2.createPercolatorKeeper)(config) : null;
+    return { feed, execution, keeper };
+}
+//# sourceMappingURL=index.js.map

package/dist/percolator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/percolator/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAkBH,0DASC;AArBD,qCAAiD;AAAxC,+GAAA,oBAAoB,OAAA;AAC7B,+CAA2D;AAAlD,yHAAA,yBAAyB,OAAA;AAClC,yCAAqD;AAA5C,mHAAA,sBAAsB,OAAA;AAM/B,uCAAiD;AACjD,iDAA2D;AAC3D,2CAAqD;AAErD,SAAgB,uBAAuB,CAAC,MAAwB;IAK9D,MAAM,IAAI,GAAG,IAAA,8BAAoB,EAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAA,wCAAyB,EAAC,MAAM,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAA,kCAAsB,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AACrC,CAAC"}

package/dist/percolator/instructions.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Percolator instruction encoders — subset for trading operations.
+ * Adapted from percolator-cli/src/abi/instructions.ts
+ */
+export interface InitUserArgs {
+    feePayment: bigint | string;
+}
+export declare function encodeInitUser(args: InitUserArgs): Buffer;
+export interface DepositCollateralArgs {
+    userIdx: number;
+    amount: bigint | string;
+}
+export declare function encodeDepositCollateral(args: DepositCollateralArgs): Buffer;
+export interface WithdrawCollateralArgs {
+    userIdx: number;
+    amount: bigint | string;
+}
+export declare function encodeWithdrawCollateral(args: WithdrawCollateralArgs): Buffer;
+export interface KeeperCrankArgs {
+    callerIdx: number;
+    allowPanic: boolean;
+}
+export declare function encodeKeeperCrank(args: KeeperCrankArgs): Buffer;
+export interface TradeCpiArgs {
+    lpIdx: number;
+    userIdx: number;
+    size: bigint | string;
+}
+export declare function encodeTradeCpi(args: TradeCpiArgs): Buffer;

package/dist/percolator/instructions.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Percolator instruction encoders — subset for trading operations.
+ * Adapted from percolator-cli/src/abi/instructions.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeInitUser = encodeInitUser;
+exports.encodeDepositCollateral = encodeDepositCollateral;
+exports.encodeWithdrawCollateral = encodeWithdrawCollateral;
+exports.encodeKeeperCrank = encodeKeeperCrank;
+exports.encodeTradeCpi = encodeTradeCpi;
+const encode_js_1 = require("./encode.js");
+const IX_TAG = {
+    InitUser: 1,
+    DepositCollateral: 3,
+    WithdrawCollateral: 4,
+    KeeperCrank: 5,
+    TradeCpi: 10,
+};
+function encodeInitUser(args) {
+    return Buffer.concat([(0, encode_js_1.encU8)(IX_TAG.InitUser), (0, encode_js_1.encU64)(args.feePayment)]);
+}
+function encodeDepositCollateral(args) {
+    return Buffer.concat([
+        (0, encode_js_1.encU8)(IX_TAG.DepositCollateral),
+        (0, encode_js_1.encU16)(args.userIdx),
+        (0, encode_js_1.encU64)(args.amount),
+    ]);
+}
+function encodeWithdrawCollateral(args) {
+    return Buffer.concat([
+        (0, encode_js_1.encU8)(IX_TAG.WithdrawCollateral),
+        (0, encode_js_1.encU16)(args.userIdx),
+        (0, encode_js_1.encU64)(args.amount),
+    ]);
+}
+function encodeKeeperCrank(args) {
+    return Buffer.concat([
+        (0, encode_js_1.encU8)(IX_TAG.KeeperCrank),
+        (0, encode_js_1.encU16)(args.callerIdx),
+        (0, encode_js_1.encU8)(args.allowPanic ? 1 : 0),
+    ]);
+}
+function encodeTradeCpi(args) {
+    return Buffer.concat([
+        (0, encode_js_1.encU8)(IX_TAG.TradeCpi),
+        (0, encode_js_1.encU16)(args.lpIdx),
+        (0, encode_js_1.encU16)(args.userIdx),
+        (0, encode_js_1.encI128)(args.size),
+    ]);
+}
+//# sourceMappingURL=instructions.js.map

package/dist/percolator/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/percolator/instructions.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAgBH,wCAEC;AAOD,0DAMC;AAOD,4DAMC;AAOD,8CAMC;AAQD,wCAOC;AAtED,2CAA6D;AAE7D,MAAM,MAAM,GAAG;IACb,QAAQ,EAAE,CAAC;IACX,iBAAiB,EAAE,CAAC;IACpB,kBAAkB,EAAE,CAAC;IACrB,WAAW,EAAE,CAAC;IACd,QAAQ,EAAE,EAAE;CACJ,CAAC;AAMX,SAAgB,cAAc,CAAC,IAAkB;IAC/C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,IAAA,iBAAK,EAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAA,kBAAM,EAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC;AAOD,SAAgB,uBAAuB,CAAC,IAA2B;IACjE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAA,iBAAK,EAAC,MAAM,CAAC,iBAAiB,CAAC;QAC/B,IAAA,kBAAM,EAAC,IAAI,CAAC,OAAO,CAAC;QACpB,IAAA,kBAAM,EAAC,IAAI,CAAC,MAAM,CAAC;KACpB,CAAC,CAAC;AACL,CAAC;AAOD,SAAgB,wBAAwB,CAAC,IAA4B;IACnE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAA,iBAAK,EAAC,MAAM,CAAC,kBAAkB,CAAC;QAChC,IAAA,kBAAM,EAAC,IAAI,CAAC,OAAO,CAAC;QACpB,IAAA,kBAAM,EAAC,IAAI,CAAC,MAAM,CAAC;KACpB,CAAC,CAAC;AACL,CAAC;AAOD,SAAgB,iBAAiB,CAAC,IAAqB;IACrD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAA,iBAAK,EAAC,MAAM,CAAC,WAAW,CAAC;QACzB,IAAA,kBAAM,EAAC,IAAI,CAAC,SAAS,CAAC;QACtB,IAAA,iBAAK,EAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAC/B,CAAC,CAAC;AACL,CAAC;AAQD,SAAgB,cAAc,CAAC,IAAkB;IAC/C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAA,iBAAK,EAAC,MAAM,CAAC,QAAQ,CAAC;QACtB,IAAA,kBAAM,EAAC,IAAI,CAAC,KAAK,CAAC;QAClB,IAAA,kBAAM,EAAC,IAAI,CAAC,OAAO,CAAC;QACpB,IAAA,mBAAO,EAAC,IAAI,CAAC,IAAI,CAAC;KACnB,CAAC,CAAC;AACL,CAAC"}

package/dist/percolator/keeper.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Percolator keeper — optional background crank runner.
+ * Permissionless: callerIdx = 65535 means "no account, just crank".
+ */
+import type { PercolatorConfig } from './types.js';
+export interface PercolatorKeeper {
+    start(): void;
+    stop(): void;
+    isRunning(): boolean;
+}
+export declare function createPercolatorKeeper(config: PercolatorConfig): PercolatorKeeper;