@agent-shield/sdk 0.1.0

package/dist/accounts.d.ts

@@ -0,0 +1,15 @@
+import { PublicKey } from "@solana/web3.js";
+import { BN, Program } from "@coral-xyz/anchor";
+import type { AgentShield, AgentVaultAccount, PolicyConfigAccount, SpendTrackerAccount, SessionAuthorityAccount } from "./types";
+export declare function getVaultPDA(owner: PublicKey, vaultId: BN, programId?: PublicKey): [PublicKey, number];
+export declare function getPolicyPDA(vault: PublicKey, programId?: PublicKey): [PublicKey, number];
+export declare function getTrackerPDA(vault: PublicKey, programId?: PublicKey): [PublicKey, number];
+export declare function getSessionPDA(vault: PublicKey, agent: PublicKey, programId?: PublicKey): [PublicKey, number];
+export declare function fetchVault(program: Program<AgentShield>, owner: PublicKey, vaultId: BN): Promise<AgentVaultAccount>;
+export declare function fetchPolicy(program: Program<AgentShield>, vault: PublicKey): Promise<PolicyConfigAccount>;
+export declare function fetchTracker(program: Program<AgentShield>, vault: PublicKey): Promise<SpendTrackerAccount>;
+export declare function fetchSession(program: Program<AgentShield>, vault: PublicKey, agent: PublicKey): Promise<SessionAuthorityAccount>;
+export declare function fetchVaultByAddress(program: Program<AgentShield>, address: PublicKey): Promise<AgentVaultAccount>;
+export declare function fetchPolicyByAddress(program: Program<AgentShield>, address: PublicKey): Promise<PolicyConfigAccount>;
+export declare function fetchTrackerByAddress(program: Program<AgentShield>, address: PublicKey): Promise<SpendTrackerAccount>;
+//# sourceMappingURL=accounts.d.ts.map

package/dist/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../src/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAKjB,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,EAAE,EACX,SAAS,GAAE,SAAmC,GAC7C,CAAC,SAAS,EAAE,MAAM,CAAC,CASrB;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAChB,SAAS,GAAE,SAAmC,GAC7C,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,EAChB,SAAS,GAAE,SAAmC,GAC7C,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,SAAS,GAAE,SAAmC,GAC7C,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAID,wBAAsB,UAAU,CAC9B,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,EAC7B,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,EAAE,GACV,OAAO,CAAC,iBAAiB,CAAC,CAK5B;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,EAC7B,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,mBAAmB,CAAC,CAK9B;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,EAC7B,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,mBAAmB,CAAC,CAK9B;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,EAC7B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,uBAAuB,CAAC,CAKlC;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,EAC7B,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,iBAAiB,CAAC,CAI5B;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,EAC7B,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,mBAAmB,CAAC,CAI9B;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,EAC7B,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,mBAAmB,CAAC,CAI9B"}

package/dist/accounts.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVaultPDA = getVaultPDA;
+exports.getPolicyPDA = getPolicyPDA;
+exports.getTrackerPDA = getTrackerPDA;
+exports.getSessionPDA = getSessionPDA;
+exports.fetchVault = fetchVault;
+exports.fetchPolicy = fetchPolicy;
+exports.fetchTracker = fetchTracker;
+exports.fetchSession = fetchSession;
+exports.fetchVaultByAddress = fetchVaultByAddress;
+exports.fetchPolicyByAddress = fetchPolicyByAddress;
+exports.fetchTrackerByAddress = fetchTrackerByAddress;
+const web3_js_1 = require("@solana/web3.js");
+const types_1 = require("./types");
+// --- PDA Derivation ---
+function getVaultPDA(owner, vaultId, programId = types_1.AGENT_SHIELD_PROGRAM_ID) {
+    return web3_js_1.PublicKey.findProgramAddressSync([
+        Buffer.from("vault"),
+        owner.toBuffer(),
+        vaultId.toArrayLike(Buffer, "le", 8),
+    ], programId);
+}
+function getPolicyPDA(vault, programId = types_1.AGENT_SHIELD_PROGRAM_ID) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("policy"), vault.toBuffer()], programId);
+}
+function getTrackerPDA(vault, programId = types_1.AGENT_SHIELD_PROGRAM_ID) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("tracker"), vault.toBuffer()], programId);
+}
+function getSessionPDA(vault, agent, programId = types_1.AGENT_SHIELD_PROGRAM_ID) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("session"), vault.toBuffer(), agent.toBuffer()], programId);
+}
+// --- Account Fetching ---
+async function fetchVault(program, owner, vaultId) {
+    const [vaultPda] = getVaultPDA(owner, vaultId, program.programId);
+    return (await program.account.agentVault.fetch(vaultPda));
+}
+async function fetchPolicy(program, vault) {
+    const [policyPda] = getPolicyPDA(vault, program.programId);
+    return (await program.account.policyConfig.fetch(policyPda));
+}
+async function fetchTracker(program, vault) {
+    const [trackerPda] = getTrackerPDA(vault, program.programId);
+    return (await program.account.spendTracker.fetch(trackerPda));
+}
+async function fetchSession(program, vault, agent) {
+    const [sessionPda] = getSessionPDA(vault, agent, program.programId);
+    return (await program.account.sessionAuthority.fetch(sessionPda));
+}
+async function fetchVaultByAddress(program, address) {
+    return (await program.account.agentVault.fetch(address));
+}
+async function fetchPolicyByAddress(program, address) {
+    return (await program.account.policyConfig.fetch(address));
+}
+async function fetchTrackerByAddress(program, address) {
+    return (await program.account.spendTracker.fetch(address));
+}
+//# sourceMappingURL=accounts.js.map

package/dist/accounts.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,85 @@
+import { PublicKey, Connection, TransactionInstruction, VersionedTransaction, Signer } from "@solana/web3.js";
+import { AnchorProvider, BN, Program, Wallet } from "@coral-xyz/anchor";
+import type { AgentShield, AgentVaultAccount, PolicyConfigAccount, SpendTrackerAccount, InitializeVaultParams, UpdatePolicyParams, AuthorizeParams, ComposeActionParams } from "./types";
+import { type JupiterQuoteParams, type JupiterQuoteResponse, type JupiterSwapParams } from "./integrations/jupiter";
+import { type FlashTradeConfig, type FlashOpenPositionParams, type FlashClosePositionParams, type FlashIncreasePositionParams, type FlashDecreasePositionParams, type FlashTradeResult } from "./integrations/flash-trade";
+import { PerpetualsClient, PoolConfig } from "flash-sdk";
+export declare class AgentShieldClient {
+    readonly program: Program<AgentShield>;
+    readonly provider: AnchorProvider;
+    constructor(connection: Connection, wallet: Wallet, programId?: PublicKey, idl?: any);
+    getVaultPDA(owner: PublicKey, vaultId: BN): [PublicKey, number];
+    getPolicyPDA(vault: PublicKey): [PublicKey, number];
+    getTrackerPDA(vault: PublicKey): [PublicKey, number];
+    getSessionPDA(vault: PublicKey, agent: PublicKey): [PublicKey, number];
+    fetchVault(owner: PublicKey, vaultId: BN): Promise<AgentVaultAccount>;
+    fetchVaultByAddress(address: PublicKey): Promise<AgentVaultAccount>;
+    fetchPolicy(vault: PublicKey): Promise<PolicyConfigAccount>;
+    fetchPolicyByAddress(address: PublicKey): Promise<PolicyConfigAccount>;
+    fetchTracker(vault: PublicKey): Promise<SpendTrackerAccount>;
+    fetchTrackerByAddress(address: PublicKey): Promise<SpendTrackerAccount>;
+    createVault(params: InitializeVaultParams): Promise<string>;
+    deposit(vault: PublicKey, mint: PublicKey, amount: BN): Promise<string>;
+    registerAgent(vault: PublicKey, agent: PublicKey): Promise<string>;
+    updatePolicy(vault: PublicKey, params: UpdatePolicyParams): Promise<string>;
+    authorizeAction(vault: PublicKey, params: AuthorizeParams): Promise<string>;
+    finalizeSession(vault: PublicKey, agent: PublicKey, success: boolean, vaultTokenAccount?: PublicKey | null, feeDestinationTokenAccount?: PublicKey | null): Promise<string>;
+    revokeAgent(vault: PublicKey): Promise<string>;
+    reactivateVault(vault: PublicKey, newAgent?: PublicKey | null): Promise<string>;
+    withdraw(vault: PublicKey, mint: PublicKey, amount: BN): Promise<string>;
+    closeVault(vault: PublicKey): Promise<string>;
+    composePermittedAction(params: ComposeActionParams, computeUnits?: number): Promise<TransactionInstruction[]>;
+    composePermittedTransaction(params: ComposeActionParams, computeUnits?: number): Promise<VersionedTransaction>;
+    composePermittedSwap(params: Omit<ComposeActionParams, "actionType">, computeUnits?: number): Promise<TransactionInstruction[]>;
+    /**
+     * Compose a permitted action, sign, and send in one call.
+     * Returns the transaction signature.
+     */
+    composeAndSend(params: ComposeActionParams, signers?: Signer[], computeUnits?: number): Promise<string>;
+    /**
+     * Fetch a swap quote from Jupiter V6 API.
+     */
+    getJupiterQuote(params: JupiterQuoteParams): Promise<JupiterQuoteResponse>;
+    /**
+     * Build an unsigned VersionedTransaction for a Jupiter swap through AgentShield.
+     *
+     * Composes: [ComputeBudget, ValidateAndAuthorize, ...JupiterIxs, FinalizeSession]
+     */
+    jupiterSwap(params: JupiterSwapParams): Promise<VersionedTransaction>;
+    /**
+     * Compose a Jupiter swap, sign, send, and confirm in one call.
+     * Returns the transaction signature.
+     */
+    executeJupiterSwap(params: JupiterSwapParams, signers?: Signer[]): Promise<string>;
+    private _perpClient;
+    private _poolConfig;
+    /**
+     * Create (or return cached) Flash Trade PerpetualsClient.
+     */
+    createFlashTradeClient(config?: Partial<FlashTradeConfig>): PerpetualsClient;
+    /**
+     * Get (or return cached) Flash Trade PoolConfig.
+     */
+    getFlashPoolConfig(poolName?: string, cluster?: "mainnet-beta" | "devnet"): PoolConfig;
+    /**
+     * Compose a Flash Trade open position through AgentShield.
+     */
+    flashTradeOpen(params: FlashOpenPositionParams, poolConfig?: PoolConfig): Promise<FlashTradeResult>;
+    /**
+     * Compose a Flash Trade close position through AgentShield.
+     */
+    flashTradeClose(params: FlashClosePositionParams, poolConfig?: PoolConfig): Promise<FlashTradeResult>;
+    /**
+     * Compose a Flash Trade increase position through AgentShield.
+     */
+    flashTradeIncrease(params: FlashIncreasePositionParams, poolConfig?: PoolConfig): Promise<FlashTradeResult>;
+    /**
+     * Compose a Flash Trade decrease position through AgentShield.
+     */
+    flashTradeDecrease(params: FlashDecreasePositionParams, poolConfig?: PoolConfig): Promise<FlashTradeResult>;
+    /**
+     * Compose a Flash Trade action, sign, send, and confirm in one call.
+     */
+    executeFlashTrade(result: FlashTradeResult, agent: PublicKey, signers?: Signer[]): Promise<string>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentShieldClient = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const anchor_1 = require("@coral-xyz/anchor");
+const accounts_1 = require("./accounts");
+const instructions_1 = require("./instructions");
+const composer_1 = require("./composer");
+const jupiter_1 = require("./integrations/jupiter");
+const flash_trade_1 = require("./integrations/flash-trade");
+const idl_json_1 = require("./idl-json");
+class AgentShieldClient {
+    constructor(connection, wallet, programId, idl) {
+        // --- Flash Trade Integration ---
+        this._perpClient = null;
+        this._poolConfig = null;
+        this.provider = new anchor_1.AnchorProvider(connection, wallet, {
+            commitment: "confirmed",
+        });
+        const resolvedIdl = idl ?? idl_json_1.IDL;
+        if (programId) {
+            resolvedIdl.address = programId.toBase58();
+        }
+        this.program = new anchor_1.Program(resolvedIdl, this.provider);
+    }
+    // --- PDA Helpers ---
+    getVaultPDA(owner, vaultId) {
+        return (0, accounts_1.getVaultPDA)(owner, vaultId, this.program.programId);
+    }
+    getPolicyPDA(vault) {
+        return (0, accounts_1.getPolicyPDA)(vault, this.program.programId);
+    }
+    getTrackerPDA(vault) {
+        return (0, accounts_1.getTrackerPDA)(vault, this.program.programId);
+    }
+    getSessionPDA(vault, agent) {
+        return (0, accounts_1.getSessionPDA)(vault, agent, this.program.programId);
+    }
+    // --- Account Fetching ---
+    async fetchVault(owner, vaultId) {
+        return (0, accounts_1.fetchVault)(this.program, owner, vaultId);
+    }
+    async fetchVaultByAddress(address) {
+        return (0, accounts_1.fetchVaultByAddress)(this.program, address);
+    }
+    async fetchPolicy(vault) {
+        return (0, accounts_1.fetchPolicy)(this.program, vault);
+    }
+    async fetchPolicyByAddress(address) {
+        return (0, accounts_1.fetchPolicyByAddress)(this.program, address);
+    }
+    async fetchTracker(vault) {
+        return (0, accounts_1.fetchTracker)(this.program, vault);
+    }
+    async fetchTrackerByAddress(address) {
+        return (0, accounts_1.fetchTrackerByAddress)(this.program, address);
+    }
+    // --- Instruction Execution (sends + confirms) ---
+    async createVault(params) {
+        const owner = this.provider.wallet.publicKey;
+        return (0, instructions_1.buildInitializeVault)(this.program, owner, params).rpc();
+    }
+    async deposit(vault, mint, amount) {
+        const owner = this.provider.wallet.publicKey;
+        return (0, instructions_1.buildDepositFunds)(this.program, owner, vault, mint, amount).rpc();
+    }
+    async registerAgent(vault, agent) {
+        const owner = this.provider.wallet.publicKey;
+        return (0, instructions_1.buildRegisterAgent)(this.program, owner, vault, agent).rpc();
+    }
+    async updatePolicy(vault, params) {
+        const owner = this.provider.wallet.publicKey;
+        return (0, instructions_1.buildUpdatePolicy)(this.program, owner, vault, params).rpc();
+    }
+    async authorizeAction(vault, params) {
+        const agent = this.provider.wallet.publicKey;
+        return (0, instructions_1.buildValidateAndAuthorize)(this.program, agent, vault, params).rpc();
+    }
+    async finalizeSession(vault, agent, success, vaultTokenAccount, feeDestinationTokenAccount) {
+        const payer = this.provider.wallet.publicKey;
+        return (0, instructions_1.buildFinalizeSession)(this.program, payer, vault, agent, success, vaultTokenAccount, feeDestinationTokenAccount).rpc();
+    }
+    async revokeAgent(vault) {
+        const owner = this.provider.wallet.publicKey;
+        return (0, instructions_1.buildRevokeAgent)(this.program, owner, vault).rpc();
+    }
+    async reactivateVault(vault, newAgent) {
+        const owner = this.provider.wallet.publicKey;
+        return (0, instructions_1.buildReactivateVault)(this.program, owner, vault, newAgent).rpc();
+    }
+    async withdraw(vault, mint, amount) {
+        const owner = this.provider.wallet.publicKey;
+        return (0, instructions_1.buildWithdrawFunds)(this.program, owner, vault, mint, amount).rpc();
+    }
+    async closeVault(vault) {
+        const owner = this.provider.wallet.publicKey;
+        return (0, instructions_1.buildCloseVault)(this.program, owner, vault).rpc();
+    }
+    // --- Composition ---
+    async composePermittedAction(params, computeUnits) {
+        return (0, composer_1.composePermittedAction)(this.program, params, computeUnits);
+    }
+    async composePermittedTransaction(params, computeUnits) {
+        return (0, composer_1.composePermittedTransaction)(this.program, this.provider.connection, params, computeUnits);
+    }
+    async composePermittedSwap(params, computeUnits) {
+        return (0, composer_1.composePermittedSwap)(this.program, params, computeUnits);
+    }
+    /**
+     * Compose a permitted action, sign, and send in one call.
+     * Returns the transaction signature.
+     */
+    async composeAndSend(params, signers, computeUnits) {
+        const instructions = await this.composePermittedAction(params, computeUnits);
+        const { blockhash, lastValidBlockHeight } = await this.provider.connection.getLatestBlockhash();
+        const messageV0 = new web3_js_1.TransactionMessage({
+            payerKey: params.agent,
+            recentBlockhash: blockhash,
+            instructions,
+        }).compileToV0Message();
+        const tx = new web3_js_1.VersionedTransaction(messageV0);
+        if (signers && signers.length > 0) {
+            tx.sign(signers);
+        }
+        const signed = await this.provider.wallet.signTransaction(tx);
+        const sig = await this.provider.connection.sendRawTransaction(signed.serialize());
+        await this.provider.connection.confirmTransaction({ signature: sig, blockhash, lastValidBlockHeight }, "confirmed");
+        return sig;
+    }
+    // --- Jupiter Integration ---
+    /**
+     * Fetch a swap quote from Jupiter V6 API.
+     */
+    async getJupiterQuote(params) {
+        return (0, jupiter_1.fetchJupiterQuote)(params);
+    }
+    /**
+     * Build an unsigned VersionedTransaction for a Jupiter swap through AgentShield.
+     *
+     * Composes: [ComputeBudget, ValidateAndAuthorize, ...JupiterIxs, FinalizeSession]
+     */
+    async jupiterSwap(params) {
+        return (0, jupiter_1.composeJupiterSwapTransaction)(this.program, this.provider.connection, params);
+    }
+    /**
+     * Compose a Jupiter swap, sign, send, and confirm in one call.
+     * Returns the transaction signature.
+     */
+    async executeJupiterSwap(params, signers) {
+        const { instructions, addressLookupTables } = await (0, jupiter_1.composeJupiterSwap)(this.program, this.provider.connection, params);
+        const { blockhash, lastValidBlockHeight } = await this.provider.connection.getLatestBlockhash();
+        const messageV0 = new web3_js_1.TransactionMessage({
+            payerKey: params.agent,
+            recentBlockhash: blockhash,
+            instructions,
+        }).compileToV0Message(addressLookupTables);
+        const tx = new web3_js_1.VersionedTransaction(messageV0);
+        if (signers && signers.length > 0) {
+            tx.sign(signers);
+        }
+        const signed = await this.provider.wallet.signTransaction(tx);
+        const sig = await this.provider.connection.sendRawTransaction(signed.serialize());
+        await this.provider.connection.confirmTransaction({ signature: sig, blockhash, lastValidBlockHeight }, "confirmed");
+        return sig;
+    }
+    /**
+     * Create (or return cached) Flash Trade PerpetualsClient.
+     */
+    createFlashTradeClient(config) {
+        if (!this._perpClient) {
+            this._perpClient = (0, flash_trade_1.createFlashTradeClient)(this.provider, config);
+        }
+        return this._perpClient;
+    }
+    /**
+     * Get (or return cached) Flash Trade PoolConfig.
+     */
+    getFlashPoolConfig(poolName = "Crypto.1", cluster = "mainnet-beta") {
+        if (!this._poolConfig) {
+            this._poolConfig = (0, flash_trade_1.getPoolConfig)(poolName, cluster);
+        }
+        return this._poolConfig;
+    }
+    /**
+     * Compose a Flash Trade open position through AgentShield.
+     */
+    async flashTradeOpen(params, poolConfig) {
+        const perpClient = this.createFlashTradeClient();
+        const config = poolConfig ?? this.getFlashPoolConfig();
+        return (0, flash_trade_1.composeFlashTradeOpen)(this.program, perpClient, config, params);
+    }
+    /**
+     * Compose a Flash Trade close position through AgentShield.
+     */
+    async flashTradeClose(params, poolConfig) {
+        const perpClient = this.createFlashTradeClient();
+        const config = poolConfig ?? this.getFlashPoolConfig();
+        return (0, flash_trade_1.composeFlashTradeClose)(this.program, perpClient, config, params);
+    }
+    /**
+     * Compose a Flash Trade increase position through AgentShield.
+     */
+    async flashTradeIncrease(params, poolConfig) {
+        const perpClient = this.createFlashTradeClient();
+        const config = poolConfig ?? this.getFlashPoolConfig();
+        return (0, flash_trade_1.composeFlashTradeIncrease)(this.program, perpClient, config, params);
+    }
+    /**
+     * Compose a Flash Trade decrease position through AgentShield.
+     */
+    async flashTradeDecrease(params, poolConfig) {
+        const perpClient = this.createFlashTradeClient();
+        const config = poolConfig ?? this.getFlashPoolConfig();
+        return (0, flash_trade_1.composeFlashTradeDecrease)(this.program, perpClient, config, params);
+    }
+    /**
+     * Compose a Flash Trade action, sign, send, and confirm in one call.
+     */
+    async executeFlashTrade(result, agent, signers) {
+        const tx = await (0, flash_trade_1.composeFlashTradeTransaction)(this.provider.connection, agent, result);
+        const allSigners = [...(result.additionalSigners || []), ...(signers || [])];
+        if (allSigners.length > 0) {
+            tx.sign(allSigners);
+        }
+        const signed = await this.provider.wallet.signTransaction(tx);
+        const sig = await this.provider.connection.sendRawTransaction(signed.serialize());
+        const { blockhash, lastValidBlockHeight } = await this.provider.connection.getLatestBlockhash();
+        await this.provider.connection.confirmTransaction({ signature: sig, blockhash, lastValidBlockHeight }, "confirmed");
+        return sig;
+    }
+}
+exports.AgentShieldClient = AgentShieldClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAAA,6CAQyB;AACzB,8CAAwE;AAWxE,yCAWoB;AACpB,iDAWwB;AACxB,yCAIoB;AACpB,oDAOgC;AAChC,4DAcoC;AAEpC,yCAAmD;AAEnD,MAAa,iBAAiB;IAI5B,YACE,UAAsB,EACtB,MAAc,EACd,SAAqB,EACrB,GAAS;QAyPX,kCAAkC;QAE1B,gBAAW,GAA4B,IAAI,CAAC;QAC5C,gBAAW,GAAsB,IAAI,CAAC;QA1P5C,IAAI,CAAC,QAAQ,GAAG,IAAI,uBAAc,CAAC,UAAU,EAAE,MAAM,EAAE;YACrD,UAAU,EAAE,WAAW;SACxB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,GAAG,IAAI,cAAc,CAAC;QAC1C,IAAI,SAAS,EAAE,CAAC;YACd,WAAW,CAAC,OAAO,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC7C,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,gBAAO,CACxB,WAAW,EACX,IAAI,CAAC,QAAQ,CACP,CAAC;IACX,CAAC;IAED,sBAAsB;IAEtB,WAAW,CAAC,KAAgB,EAAE,OAAW;QACvC,OAAO,IAAA,sBAAW,EAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED,YAAY,CAAC,KAAgB;QAC3B,OAAO,IAAA,uBAAY,EAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAED,aAAa,CAAC,KAAgB;QAC5B,OAAO,IAAA,wBAAa,EAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;IAED,aAAa,CAAC,KAAgB,EAAE,KAAgB;QAC9C,OAAO,IAAA,wBAAa,EAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED,2BAA2B;IAE3B,KAAK,CAAC,UAAU,CAAC,KAAgB,EAAE,OAAW;QAC5C,OAAO,IAAA,qBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,OAAkB;QAC1C,OAAO,IAAA,8BAAmB,EAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAgB;QAChC,OAAO,IAAA,sBAAW,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,OAAkB;QAC3C,OAAO,IAAA,+BAAoB,EAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAgB;QACjC,OAAO,IAAA,uBAAY,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,OAAkB;QAC5C,OAAO,IAAA,gCAAqB,EAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,mDAAmD;IAEnD,KAAK,CAAC,WAAW,CAAC,MAA6B;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QAC7C,OAAO,IAAA,mCAAoB,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAgB,EAAE,IAAe,EAAE,MAAU;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QAC7C,OAAO,IAAA,gCAAiB,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAAgB,EAAE,KAAgB;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QAC7C,OAAO,IAAA,iCAAkB,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAgB,EAAE,MAA0B;QAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QAC7C,OAAO,IAAA,gCAAiB,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,KAAgB,EAAE,MAAuB;QAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QAC7C,OAAO,IAAA,wCAAyB,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,KAAgB,EAChB,KAAgB,EAChB,OAAgB,EAChB,iBAAoC,EACpC,0BAA6C;QAE7C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QAC7C,OAAO,IAAA,mCAAoB,EACzB,IAAI,CAAC,OAAO,EACZ,KAAK,EACL,KAAK,EACL,KAAK,EACL,OAAO,EACP,iBAAiB,EACjB,0BAA0B,CAC3B,CAAC,GAAG,EAAE,CAAC;IACV,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAgB;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QAC7C,OAAO,IAAA,+BAAgB,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,KAAgB,EAAE,QAA2B;QACjE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QAC7C,OAAO,IAAA,mCAAoB,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAgB,EAAE,IAAe,EAAE,MAAU;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QAC7C,OAAO,IAAA,iCAAkB,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAgB;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QAC7C,OAAO,IAAA,8BAAe,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC;IAC3D,CAAC;IAED,sBAAsB;IAEtB,KAAK,CAAC,sBAAsB,CAC1B,MAA2B,EAC3B,YAAqB;QAErB,OAAO,IAAA,iCAAsB,EAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,2BAA2B,CAC/B,MAA2B,EAC3B,YAAqB;QAErB,OAAO,IAAA,sCAA2B,EAChC,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,QAAQ,CAAC,UAAU,EACxB,MAAM,EACN,YAAY,CACb,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,MAA+C,EAC/C,YAAqB;QAErB,OAAO,IAAA,+BAAoB,EAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IAClE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAClB,MAA2B,EAC3B,OAAkB,EAClB,YAAqB;QAErB,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC7E,MAAM,EAAE,SAAS,EAAE,oBAAoB,EAAE,GACvC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC;QAEtD,MAAM,SAAS,GAAG,IAAI,4BAAkB,CAAC;YACvC,QAAQ,EAAE,MAAM,CAAC,KAAK;YACtB,eAAe,EAAE,SAAS;YAC1B,YAAY;SACb,CAAC,CAAC,kBAAkB,EAAE,CAAC;QAExB,MAAM,EAAE,GAAG,IAAI,8BAAoB,CAAC,SAAS,CAAC,CAAC;QAE/C,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAClF,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,kBAAkB,CAC/C,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,oBAAoB,EAAE,EACnD,WAAW,CACZ,CAAC;QAEF,OAAO,GAAG,CAAC;IACb,CAAC;IAED,8BAA8B;IAE9B;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,MAA0B;QAC9C,OAAO,IAAA,2BAAiB,EAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,MAAyB;QACzC,OAAO,IAAA,uCAA6B,EAClC,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,QAAQ,CAAC,UAAU,EACxB,MAAM,CACP,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,kBAAkB,CACtB,MAAyB,EACzB,OAAkB;QAElB,MAAM,EAAE,YAAY,EAAE,mBAAmB,EAAE,GAAG,MAAM,IAAA,4BAAkB,EACpE,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,QAAQ,CAAC,UAAU,EACxB,MAAM,CACP,CAAC;QAEF,MAAM,EAAE,SAAS,EAAE,oBAAoB,EAAE,GACvC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC;QAEtD,MAAM,SAAS,GAAG,IAAI,4BAAkB,CAAC;YACvC,QAAQ,EAAE,MAAM,CAAC,KAAK;YACtB,eAAe,EAAE,SAAS;YAC1B,YAAY;SACb,CAAC,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;QAE3C,MAAM,EAAE,GAAG,IAAI,8BAAoB,CAAC,SAAS,CAAC,CAAC;QAE/C,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAClF,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,kBAAkB,CAC/C,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,oBAAoB,EAAE,EACnD,WAAW,CACZ,CAAC;QAEF,OAAO,GAAG,CAAC;IACb,CAAC;IAOD;;OAEG;IACH,sBAAsB,CAAC,MAAkC;QACvD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,GAAG,IAAA,oCAAuB,EAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,kBAAkB,CAChB,WAAmB,UAAU,EAC7B,UAAqC,cAAc;QAEnD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,GAAG,IAAA,2BAAa,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,MAA+B,EAC/B,UAAuB;QAEvB,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,UAAU,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACvD,OAAO,IAAA,mCAAqB,EAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CACnB,MAAgC,EAChC,UAAuB;QAEvB,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,UAAU,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACvD,OAAO,IAAA,oCAAsB,EAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CACtB,MAAmC,EACnC,UAAuB;QAEvB,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,UAAU,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACvD,OAAO,IAAA,uCAAyB,EAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CACtB,MAAmC,EACnC,UAAuB;QAEvB,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,UAAU,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACvD,OAAO,IAAA,uCAAyB,EAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CACrB,MAAwB,EACxB,KAAgB,EAChB,OAAkB;QAElB,MAAM,EAAE,GAAG,MAAM,IAAA,0CAA4B,EAC3C,IAAI,CAAC,QAAQ,CAAC,UAAU,EACxB,KAAK,EACL,MAAM,CACP,CAAC;QAEF,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7E,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAClF,MAAM,EAAE,SAAS,EAAE,oBAAoB,EAAE,GACvC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC;QACtD,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,kBAAkB,CAC/C,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,oBAAoB,EAAE,EACnD,WAAW,CACZ,CAAC;QAEF,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AA3WD,8CA2WC"}

package/dist/composer.d.ts

@@ -0,0 +1,21 @@
+import { TransactionInstruction, VersionedTransaction, Connection } from "@solana/web3.js";
+import { Program } from "@coral-xyz/anchor";
+import type { AgentShield, ComposeActionParams } from "./types";
+/**
+ * Build an atomic composed transaction:
+ * [ComputeBudget, ValidateAndAuthorize, ...defiInstructions, FinalizeSession]
+ *
+ * All instructions succeed or all revert atomically.
+ */
+export declare function composePermittedAction(program: Program<AgentShield>, params: ComposeActionParams, computeUnits?: number): Promise<TransactionInstruction[]>;
+/**
+ * Build and return a VersionedTransaction for a composed permitted action.
+ * The transaction is NOT signed — caller must sign with the agent keypair.
+ */
+export declare function composePermittedTransaction(program: Program<AgentShield>, connection: Connection, params: ComposeActionParams, computeUnits?: number): Promise<VersionedTransaction>;
+/**
+ * Convenience: compose a swap action specifically.
+ * Wraps composePermittedAction with actionType = { swap: {} }.
+ */
+export declare function composePermittedSwap(program: Program<AgentShield>, params: Omit<ComposeActionParams, "actionType">, computeUnits?: number): Promise<TransactionInstruction[]>;
+//# sourceMappingURL=composer.d.ts.map

package/dist/composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer.d.ts","sourceRoot":"","sources":["../src/composer.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EAEtB,oBAAoB,EAEpB,UAAU,EACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAMhE;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,EAC7B,MAAM,EAAE,mBAAmB,EAC3B,YAAY,GAAE,MAA8B,GAC3C,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAwBnC;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,EAC7B,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,mBAAmB,EAC3B,YAAY,GAAE,MAA8B,GAC3C,OAAO,CAAC,oBAAoB,CAAC,CAW/B;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,EAC7B,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,YAAY,CAAC,EAC/C,YAAY,GAAE,MAA8B,GAC3C,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAMnC"}

package/dist/composer.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.composePermittedAction = composePermittedAction;
+exports.composePermittedTransaction = composePermittedTransaction;
+exports.composePermittedSwap = composePermittedSwap;
+const web3_js_1 = require("@solana/web3.js");
+const instructions_1 = require("./instructions");
+/** Default compute budget for composed transactions (1.4M CU) */
+const DEFAULT_COMPUTE_UNITS = 1400000;
+/**
+ * Build an atomic composed transaction:
+ * [ComputeBudget, ValidateAndAuthorize, ...defiInstructions, FinalizeSession]
+ *
+ * All instructions succeed or all revert atomically.
+ */
+async function composePermittedAction(program, params, computeUnits = DEFAULT_COMPUTE_UNITS) {
+    const computeBudgetIx = web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({
+        units: computeUnits,
+    });
+    const validateIx = await (0, instructions_1.buildValidateAndAuthorize)(program, params.agent, params.vault, {
+        actionType: params.actionType,
+        tokenMint: params.tokenMint,
+        amount: params.amount,
+        targetProtocol: params.targetProtocol,
+        leverageBps: params.leverageBps,
+    }).instruction();
+    const finalizeIx = await (0, instructions_1.buildFinalizeSession)(program, params.agent, params.vault, params.agent, params.success ?? true, params.vaultTokenAccount, params.feeDestinationTokenAccount).instruction();
+    return [computeBudgetIx, validateIx, ...params.defiInstructions, finalizeIx];
+}
+/**
+ * Build and return a VersionedTransaction for a composed permitted action.
+ * The transaction is NOT signed — caller must sign with the agent keypair.
+ */
+async function composePermittedTransaction(program, connection, params, computeUnits = DEFAULT_COMPUTE_UNITS) {
+    const instructions = await composePermittedAction(program, params, computeUnits);
+    const { blockhash } = await connection.getLatestBlockhash();
+    const messageV0 = new web3_js_1.TransactionMessage({
+        payerKey: params.agent,
+        recentBlockhash: blockhash,
+        instructions,
+    }).compileToV0Message();
+    return new web3_js_1.VersionedTransaction(messageV0);
+}
+/**
+ * Convenience: compose a swap action specifically.
+ * Wraps composePermittedAction with actionType = { swap: {} }.
+ */
+async function composePermittedSwap(program, params, computeUnits = DEFAULT_COMPUTE_UNITS) {
+    return composePermittedAction(program, { ...params, actionType: { swap: {} } }, computeUnits);
+}
+//# sourceMappingURL=composer.js.map

package/dist/composer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer.js","sourceRoot":"","sources":["../src/composer.ts"],"names":[],"mappings":";;AAqBA,wDA4BC;AAMD,kEAgBC;AAMD,oDAUC;AAvFD,6CAOyB;AAGzB,iDAAiF;AAEjF,iEAAiE;AACjE,MAAM,qBAAqB,GAAG,OAAS,CAAC;AAExC;;;;;GAKG;AACI,KAAK,UAAU,sBAAsB,CAC1C,OAA6B,EAC7B,MAA2B,EAC3B,eAAuB,qBAAqB;IAE5C,MAAM,eAAe,GAAG,8BAAoB,CAAC,mBAAmB,CAAC;QAC/D,KAAK,EAAE,YAAY;KACpB,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,MAAM,IAAA,wCAAyB,EAAC,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;QACtF,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC,WAAW,EAAE,CAAC;IAEjB,MAAM,UAAU,GAAG,MAAM,IAAA,mCAAoB,EAC3C,OAAO,EACP,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,OAAO,IAAI,IAAI,EACtB,MAAM,CAAC,iBAAiB,EACxB,MAAM,CAAC,0BAA0B,CAClC,CAAC,WAAW,EAAE,CAAC;IAEhB,OAAO,CAAC,eAAe,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,2BAA2B,CAC/C,OAA6B,EAC7B,UAAsB,EACtB,MAA2B,EAC3B,eAAuB,qBAAqB;IAE5C,MAAM,YAAY,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IACjF,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,UAAU,CAAC,kBAAkB,EAAE,CAAC;IAE5D,MAAM,SAAS,GAAG,IAAI,4BAAkB,CAAC;QACvC,QAAQ,EAAE,MAAM,CAAC,KAAK;QACtB,eAAe,EAAE,SAAS;QAC1B,YAAY;KACb,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAExB,OAAO,IAAI,8BAAoB,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,oBAAoB,CACxC,OAA6B,EAC7B,MAA+C,EAC/C,eAAuB,qBAAqB;IAE5C,OAAO,sBAAsB,CAC3B,OAAO,EACP,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EACvC,YAAY,CACb,CAAC;AACJ,CAAC"}