@agent-shield/sdk 0.1.0

package/dist/instructions.d.ts.map

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

package/dist/instructions.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildInitializeVault = buildInitializeVault;
+exports.buildDepositFunds = buildDepositFunds;
+exports.buildRegisterAgent = buildRegisterAgent;
+exports.buildUpdatePolicy = buildUpdatePolicy;
+exports.buildValidateAndAuthorize = buildValidateAndAuthorize;
+exports.buildFinalizeSession = buildFinalizeSession;
+exports.buildRevokeAgent = buildRevokeAgent;
+exports.buildReactivateVault = buildReactivateVault;
+exports.buildWithdrawFunds = buildWithdrawFunds;
+exports.buildCloseVault = buildCloseVault;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+const accounts_1 = require("./accounts");
+function buildInitializeVault(program, owner, params) {
+    const [vault] = (0, accounts_1.getVaultPDA)(owner, params.vaultId, program.programId);
+    const [policy] = (0, accounts_1.getPolicyPDA)(vault, program.programId);
+    const [tracker] = (0, accounts_1.getTrackerPDA)(vault, program.programId);
+    return program.methods
+        .initializeVault(params.vaultId, params.dailySpendingCap, params.maxTransactionSize, params.allowedTokens, params.allowedProtocols, params.maxLeverageBps, params.maxConcurrentPositions)
+        .accounts({
+        owner,
+        vault,
+        policy,
+        tracker,
+        feeDestination: params.feeDestination,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    });
+}
+function buildDepositFunds(program, owner, vault, mint, amount) {
+    const ownerTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, owner);
+    const vaultTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, vault, true);
+    return program.methods.depositFunds(amount).accounts({
+        owner,
+        vault,
+        mint,
+        ownerTokenAccount,
+        vaultTokenAccount,
+        tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    });
+}
+function buildRegisterAgent(program, owner, vault, agent) {
+    return program.methods.registerAgent(agent).accounts({
+        owner,
+        vault,
+    });
+}
+function buildUpdatePolicy(program, owner, vault, params) {
+    const [policy] = (0, accounts_1.getPolicyPDA)(vault, program.programId);
+    return program.methods
+        .updatePolicy(params.dailySpendingCap ?? null, params.maxTransactionSize ?? null, params.allowedTokens ?? null, params.allowedProtocols ?? null, params.maxLeverageBps ?? null, params.canOpenPositions ?? null, params.maxConcurrentPositions ?? null)
+        .accounts({
+        owner,
+        vault,
+        policy,
+    });
+}
+function buildValidateAndAuthorize(program, agent, vault, params) {
+    const [policy] = (0, accounts_1.getPolicyPDA)(vault, program.programId);
+    const [tracker] = (0, accounts_1.getTrackerPDA)(vault, program.programId);
+    const [session] = (0, accounts_1.getSessionPDA)(vault, agent, program.programId);
+    return program.methods
+        .validateAndAuthorize(params.actionType, params.tokenMint, params.amount, params.targetProtocol, params.leverageBps ?? null)
+        .accounts({
+        agent,
+        vault,
+        policy,
+        tracker,
+        session,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    });
+}
+function buildFinalizeSession(program, payer, vault, agent, success, vaultTokenAccount, feeDestinationTokenAccount) {
+    const [policy] = (0, accounts_1.getPolicyPDA)(vault, program.programId);
+    const [tracker] = (0, accounts_1.getTrackerPDA)(vault, program.programId);
+    const [session] = (0, accounts_1.getSessionPDA)(vault, agent, program.programId);
+    return program.methods.finalizeSession(success).accounts({
+        payer,
+        vault,
+        policy,
+        tracker,
+        session,
+        vaultTokenAccount: vaultTokenAccount ?? null,
+        feeDestinationTokenAccount: feeDestinationTokenAccount ?? null,
+        tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    });
+}
+function buildRevokeAgent(program, owner, vault) {
+    return program.methods.revokeAgent().accounts({
+        owner,
+        vault,
+    });
+}
+function buildReactivateVault(program, owner, vault, newAgent) {
+    return program.methods.reactivateVault(newAgent ?? null).accounts({
+        owner,
+        vault,
+    });
+}
+function buildWithdrawFunds(program, owner, vault, mint, amount) {
+    const vaultTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, vault, true);
+    const ownerTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, owner);
+    return program.methods.withdrawFunds(amount).accounts({
+        owner,
+        vault,
+        mint,
+        vaultTokenAccount,
+        ownerTokenAccount,
+        tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+    });
+}
+function buildCloseVault(program, owner, vault) {
+    const [policy] = (0, accounts_1.getPolicyPDA)(vault, program.programId);
+    const [tracker] = (0, accounts_1.getTrackerPDA)(vault, program.programId);
+    return program.methods.closeVault().accounts({
+        owner,
+        vault,
+        policy,
+        tracker,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    });
+}
+//# sourceMappingURL=instructions.js.map

package/dist/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":";;AAgBA,oDA2BC;AAED,8CAoBC;AAED,gDAUC;AAED,8CAuBC;AAED,8DA0BC;AAED,oDAwBC;AAED,4CASC;AAED,oDAUC;AAED,gDAkBC;AAED,0CAeC;AAxND,6CAA2D;AAE3D,iDAI2B;AAQ3B,yCAAqF;AAErF,SAAgB,oBAAoB,CAClC,OAA6B,EAC7B,KAAgB,EAChB,MAA6B;IAE7B,MAAM,CAAC,KAAK,CAAC,GAAG,IAAA,sBAAW,EAAC,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACtE,MAAM,CAAC,MAAM,CAAC,GAAG,IAAA,uBAAY,EAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,MAAM,CAAC,OAAO,CAAC,GAAG,IAAA,wBAAa,EAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAE1D,OAAO,OAAO,CAAC,OAAO;SACnB,eAAe,CACd,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,gBAAgB,EACvB,MAAM,CAAC,kBAAkB,EACzB,MAAM,CAAC,aAAa,EACpB,MAAM,CAAC,gBAAgB,EACvB,MAAM,CAAC,cAAc,EACrB,MAAM,CAAC,sBAAsB,CAC9B;SACA,QAAQ,CAAC;QACR,KAAK;QACL,KAAK;QACL,MAAM;QACN,OAAO;QACP,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,aAAa,EAAE,uBAAa,CAAC,SAAS;KAChC,CAAC,CAAC;AACd,CAAC;AAED,SAAgB,iBAAiB,CAC/B,OAA6B,EAC7B,KAAgB,EAChB,KAAgB,EAChB,IAAe,EACf,MAAU;IAEV,MAAM,iBAAiB,GAAG,IAAA,yCAA6B,EAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrE,MAAM,iBAAiB,GAAG,IAAA,yCAA6B,EAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAE3E,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC;QACnD,KAAK;QACL,KAAK;QACL,IAAI;QACJ,iBAAiB;QACjB,iBAAiB;QACjB,YAAY,EAAE,4BAAgB;QAC9B,sBAAsB,EAAE,uCAA2B;QACnD,aAAa,EAAE,uBAAa,CAAC,SAAS;KAChC,CAAC,CAAC;AACZ,CAAC;AAED,SAAgB,kBAAkB,CAChC,OAA6B,EAC7B,KAAgB,EAChB,KAAgB,EAChB,KAAgB;IAEhB,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC;QACnD,KAAK;QACL,KAAK;KACC,CAAC,CAAC;AACZ,CAAC;AAED,SAAgB,iBAAiB,CAC/B,OAA6B,EAC7B,KAAgB,EAChB,KAAgB,EAChB,MAA0B;IAE1B,MAAM,CAAC,MAAM,CAAC,GAAG,IAAA,uBAAY,EAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAExD,OAAO,OAAO,CAAC,OAAO;SACnB,YAAY,CACX,MAAM,CAAC,gBAAgB,IAAI,IAAI,EAC/B,MAAM,CAAC,kBAAkB,IAAI,IAAI,EACjC,MAAM,CAAC,aAAa,IAAI,IAAI,EAC5B,MAAM,CAAC,gBAAgB,IAAI,IAAI,EAC/B,MAAM,CAAC,cAAc,IAAI,IAAI,EAC7B,MAAM,CAAC,gBAAgB,IAAI,IAAI,EAC/B,MAAM,CAAC,sBAAsB,IAAI,IAAI,CACtC;SACA,QAAQ,CAAC;QACR,KAAK;QACL,KAAK;QACL,MAAM;KACA,CAAC,CAAC;AACd,CAAC;AAED,SAAgB,yBAAyB,CACvC,OAA6B,EAC7B,KAAgB,EAChB,KAAgB,EAChB,MAAuB;IAEvB,MAAM,CAAC,MAAM,CAAC,GAAG,IAAA,uBAAY,EAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,MAAM,CAAC,OAAO,CAAC,GAAG,IAAA,wBAAa,EAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,CAAC,OAAO,CAAC,GAAG,IAAA,wBAAa,EAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAEjE,OAAO,OAAO,CAAC,OAAO;SACnB,oBAAoB,CACnB,MAAM,CAAC,UAAiB,EACxB,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,cAAc,EACrB,MAAM,CAAC,WAAW,IAAI,IAAI,CAC3B;SACA,QAAQ,CAAC;QACR,KAAK;QACL,KAAK;QACL,MAAM;QACN,OAAO;QACP,OAAO;QACP,aAAa,EAAE,uBAAa,CAAC,SAAS;KAChC,CAAC,CAAC;AACd,CAAC;AAED,SAAgB,oBAAoB,CAClC,OAA6B,EAC7B,KAAgB,EAChB,KAAgB,EAChB,KAAgB,EAChB,OAAgB,EAChB,iBAAoC,EACpC,0BAA6C;IAE7C,MAAM,CAAC,MAAM,CAAC,GAAG,IAAA,uBAAY,EAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,MAAM,CAAC,OAAO,CAAC,GAAG,IAAA,wBAAa,EAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,CAAC,OAAO,CAAC,GAAG,IAAA,wBAAa,EAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAEjE,OAAO,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC;QACvD,KAAK;QACL,KAAK;QACL,MAAM;QACN,OAAO;QACP,OAAO;QACP,iBAAiB,EAAE,iBAAiB,IAAI,IAAI;QAC5C,0BAA0B,EAAE,0BAA0B,IAAI,IAAI;QAC9D,YAAY,EAAE,4BAAgB;QAC9B,aAAa,EAAE,uBAAa,CAAC,SAAS;KAChC,CAAC,CAAC;AACZ,CAAC;AAED,SAAgB,gBAAgB,CAC9B,OAA6B,EAC7B,KAAgB,EAChB,KAAgB;IAEhB,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC;QAC5C,KAAK;QACL,KAAK;KACC,CAAC,CAAC;AACZ,CAAC;AAED,SAAgB,oBAAoB,CAClC,OAA6B,EAC7B,KAAgB,EAChB,KAAgB,EAChB,QAA2B;IAE3B,OAAO,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,QAAQ,CAAC;QAChE,KAAK;QACL,KAAK;KACC,CAAC,CAAC;AACZ,CAAC;AAED,SAAgB,kBAAkB,CAChC,OAA6B,EAC7B,KAAgB,EAChB,KAAgB,EAChB,IAAe,EACf,MAAU;IAEV,MAAM,iBAAiB,GAAG,IAAA,yCAA6B,EAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC3E,MAAM,iBAAiB,GAAG,IAAA,yCAA6B,EAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAErE,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC;QACpD,KAAK;QACL,KAAK;QACL,IAAI;QACJ,iBAAiB;QACjB,iBAAiB;QACjB,YAAY,EAAE,4BAAgB;KACxB,CAAC,CAAC;AACZ,CAAC;AAED,SAAgB,eAAe,CAC7B,OAA6B,EAC7B,KAAgB,EAChB,KAAgB;IAEhB,MAAM,CAAC,MAAM,CAAC,GAAG,IAAA,uBAAY,EAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,MAAM,CAAC,OAAO,CAAC,GAAG,IAAA,wBAAa,EAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAE1D,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC;QAC3C,KAAK;QACL,KAAK;QACL,MAAM;QACN,OAAO;QACP,aAAa,EAAE,uBAAa,CAAC,SAAS;KAChC,CAAC,CAAC;AACZ,CAAC"}

package/dist/integrations/flash-trade.d.ts

@@ -0,0 +1,130 @@
+import { PublicKey, TransactionInstruction, VersionedTransaction, Connection, Signer } from "@solana/web3.js";
+import { AnchorProvider, BN, Program } from "@coral-xyz/anchor";
+import { PerpetualsClient, PoolConfig } from "flash-sdk";
+import type { AgentShield } from "../types";
+export declare const FLASH_TRADE_PROGRAM_ID: PublicKey;
+export declare const FLASH_COMPOSABILITY_PROGRAM_ID: PublicKey;
+export declare const FLASH_FB_NFT_REWARD_PROGRAM_ID: PublicKey;
+export declare const FLASH_REWARD_DISTRIBUTION_PROGRAM_ID: PublicKey;
+export { Side, Privilege } from "flash-sdk";
+export interface FlashTradeConfig {
+    /** Pool name, e.g. "Crypto.1" */
+    poolName: string;
+    /** Cluster for PoolConfig lookup */
+    cluster: "mainnet-beta" | "devnet";
+}
+export interface ContractOraclePrice {
+    price: BN;
+    exponent: number;
+}
+export interface FlashOpenPositionParams {
+    owner: PublicKey;
+    vaultId: BN;
+    agent: PublicKey;
+    targetSymbol: string;
+    collateralSymbol: string;
+    collateralAmount: BN;
+    sizeAmount: BN;
+    side: {
+        long: Record<string, never>;
+    } | {
+        short: Record<string, never>;
+    };
+    priceWithSlippage: ContractOraclePrice;
+    leverageBps: number;
+    vaultTokenAccount?: PublicKey | null;
+    feeDestinationTokenAccount?: PublicKey | null;
+}
+export interface FlashClosePositionParams {
+    owner: PublicKey;
+    vaultId: BN;
+    agent: PublicKey;
+    targetSymbol: string;
+    collateralSymbol: string;
+    collateralAmount: BN;
+    side: {
+        long: Record<string, never>;
+    } | {
+        short: Record<string, never>;
+    };
+    priceWithSlippage: ContractOraclePrice;
+    vaultTokenAccount?: PublicKey | null;
+    feeDestinationTokenAccount?: PublicKey | null;
+}
+export interface FlashIncreasePositionParams {
+    owner: PublicKey;
+    vaultId: BN;
+    agent: PublicKey;
+    targetSymbol: string;
+    collateralSymbol: string;
+    positionPubKey: PublicKey;
+    side: {
+        long: Record<string, never>;
+    } | {
+        short: Record<string, never>;
+    };
+    priceWithSlippage: ContractOraclePrice;
+    sizeDelta: BN;
+    collateralAmount: BN;
+    leverageBps: number;
+    vaultTokenAccount?: PublicKey | null;
+    feeDestinationTokenAccount?: PublicKey | null;
+}
+export interface FlashDecreasePositionParams {
+    owner: PublicKey;
+    vaultId: BN;
+    agent: PublicKey;
+    targetSymbol: string;
+    collateralSymbol: string;
+    positionPubKey: PublicKey;
+    side: {
+        long: Record<string, never>;
+    } | {
+        short: Record<string, never>;
+    };
+    priceWithSlippage: ContractOraclePrice;
+    sizeDelta: BN;
+    collateralAmount: BN;
+    vaultTokenAccount?: PublicKey | null;
+    feeDestinationTokenAccount?: PublicKey | null;
+}
+export interface FlashTradeResult {
+    instructions: TransactionInstruction[];
+    additionalSigners: Signer[];
+}
+/**
+ * Create a PerpetualsClient from flash-sdk configured for a specific pool.
+ *
+ * The `provider` should use the vault PDA as the wallet (since the vault
+ * owns the token accounts and positions in instruction composition mode).
+ */
+export declare function createFlashTradeClient(provider: AnchorProvider, config?: Partial<FlashTradeConfig>): PerpetualsClient;
+/**
+ * Load pool config for a given pool name and cluster.
+ */
+export declare function getPoolConfig(poolName: string, cluster?: "mainnet-beta" | "devnet"): PoolConfig;
+/**
+ * Compose a Flash Trade open position through AgentShield.
+ *
+ * Returns: [ComputeBudget, ValidateAndAuthorize, ...flashIxs, FinalizeSession]
+ */
+export declare function composeFlashTradeOpen(program: Program<AgentShield>, perpClient: PerpetualsClient, poolConfig: PoolConfig, params: FlashOpenPositionParams): Promise<FlashTradeResult>;
+/**
+ * Compose a Flash Trade close position through AgentShield.
+ */
+export declare function composeFlashTradeClose(program: Program<AgentShield>, perpClient: PerpetualsClient, poolConfig: PoolConfig, params: FlashClosePositionParams): Promise<FlashTradeResult>;
+/**
+ * Compose a Flash Trade increase position through AgentShield.
+ */
+export declare function composeFlashTradeIncrease(program: Program<AgentShield>, perpClient: PerpetualsClient, poolConfig: PoolConfig, params: FlashIncreasePositionParams): Promise<FlashTradeResult>;
+/**
+ * Compose a Flash Trade decrease position through AgentShield.
+ */
+export declare function composeFlashTradeDecrease(program: Program<AgentShield>, perpClient: PerpetualsClient, poolConfig: PoolConfig, params: FlashDecreasePositionParams): Promise<FlashTradeResult>;
+/**
+ * Build a complete VersionedTransaction for a Flash Trade operation.
+ * The transaction is NOT signed — caller must sign with the agent keypair
+ * and any additionalSigners.
+ */
+export declare function composeFlashTradeTransaction(connection: Connection, payer: PublicKey, result: FlashTradeResult): Promise<VersionedTransaction>;
+//# sourceMappingURL=flash-trade.d.ts.map

package/dist/integrations/flash-trade.d.ts.map

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

package/dist/integrations/flash-trade.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Privilege = exports.Side = exports.FLASH_REWARD_DISTRIBUTION_PROGRAM_ID = exports.FLASH_FB_NFT_REWARD_PROGRAM_ID = exports.FLASH_COMPOSABILITY_PROGRAM_ID = exports.FLASH_TRADE_PROGRAM_ID = void 0;
+exports.createFlashTradeClient = createFlashTradeClient;
+exports.getPoolConfig = getPoolConfig;
+exports.composeFlashTradeOpen = composeFlashTradeOpen;
+exports.composeFlashTradeClose = composeFlashTradeClose;
+exports.composeFlashTradeIncrease = composeFlashTradeIncrease;
+exports.composeFlashTradeDecrease = composeFlashTradeDecrease;
+exports.composeFlashTradeTransaction = composeFlashTradeTransaction;
+const web3_js_1 = require("@solana/web3.js");
+const flash_sdk_1 = require("flash-sdk");
+const accounts_1 = require("../accounts");
+const composer_1 = require("../composer");
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+exports.FLASH_TRADE_PROGRAM_ID = new web3_js_1.PublicKey("PERPHjGBqRHArX4DySjwM6UJHiR3sWAatqfdBS2qQJu");
+exports.FLASH_COMPOSABILITY_PROGRAM_ID = new web3_js_1.PublicKey("FLCPaG22cpZBSdbmk6kBhHsGDfkJGHsSRhgSt9kPV7sG");
+exports.FLASH_FB_NFT_REWARD_PROGRAM_ID = new web3_js_1.PublicKey("FBnftwLhsQJPHkGEjVVgPXnxFjTsePDqQnmzixiJbsAV");
+exports.FLASH_REWARD_DISTRIBUTION_PROGRAM_ID = new web3_js_1.PublicKey("FLRDaTyVhUFJwdwtBjCKMDGNbMFrHm5GVXE1aVjMCaH1");
+// Re-export flash-sdk types for consumers
+var flash_sdk_2 = require("flash-sdk");
+Object.defineProperty(exports, "Side", { enumerable: true, get: function () { return flash_sdk_2.Side; } });
+Object.defineProperty(exports, "Privilege", { enumerable: true, get: function () { return flash_sdk_2.Privilege; } });
+// ---------------------------------------------------------------------------
+// Client Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a PerpetualsClient from flash-sdk configured for a specific pool.
+ *
+ * The `provider` should use the vault PDA as the wallet (since the vault
+ * owns the token accounts and positions in instruction composition mode).
+ */
+function createFlashTradeClient(provider, config) {
+    return new flash_sdk_1.PerpetualsClient(provider, exports.FLASH_TRADE_PROGRAM_ID, exports.FLASH_COMPOSABILITY_PROGRAM_ID, exports.FLASH_FB_NFT_REWARD_PROGRAM_ID, exports.FLASH_REWARD_DISTRIBUTION_PROGRAM_ID, {}, false);
+}
+/**
+ * Load pool config for a given pool name and cluster.
+ */
+function getPoolConfig(poolName, cluster = "mainnet-beta") {
+    return flash_sdk_1.PoolConfig.fromIdsByName(poolName, cluster);
+}
+// ---------------------------------------------------------------------------
+// Composition Functions
+// ---------------------------------------------------------------------------
+/**
+ * Compose a Flash Trade open position through AgentShield.
+ *
+ * Returns: [ComputeBudget, ValidateAndAuthorize, ...flashIxs, FinalizeSession]
+ */
+async function composeFlashTradeOpen(program, perpClient, poolConfig, params) {
+    const [vault] = (0, accounts_1.getVaultPDA)(params.owner, params.vaultId, program.programId);
+    // Get raw Flash Trade instructions
+    const { instructions: flashIxs, additionalSigners } = await perpClient.openPosition(params.targetSymbol, params.collateralSymbol, params.priceWithSlippage, params.collateralAmount, params.sizeAmount, params.side, poolConfig, flash_sdk_1.Privilege.None, undefined, // tokenStakeAccount
+    undefined, // userReferralAccount
+    true // skipBalanceChecks
+    );
+    // Get collateral token mint from pool config
+    const collateralToken = poolConfig.getTokenFromSymbol(params.collateralSymbol);
+    const tokenMint = collateralToken.mintKey;
+    const composeParams = {
+        vault,
+        owner: params.owner,
+        vaultId: params.vaultId,
+        agent: params.agent,
+        actionType: { openPosition: {} },
+        tokenMint,
+        amount: params.collateralAmount,
+        targetProtocol: exports.FLASH_TRADE_PROGRAM_ID,
+        leverageBps: params.leverageBps,
+        defiInstructions: flashIxs,
+        success: true,
+        vaultTokenAccount: params.vaultTokenAccount,
+        feeDestinationTokenAccount: params.feeDestinationTokenAccount,
+    };
+    const instructions = await (0, composer_1.composePermittedAction)(program, composeParams);
+    return { instructions, additionalSigners };
+}
+/**
+ * Compose a Flash Trade close position through AgentShield.
+ */
+async function composeFlashTradeClose(program, perpClient, poolConfig, params) {
+    const [vault] = (0, accounts_1.getVaultPDA)(params.owner, params.vaultId, program.programId);
+    const { instructions: flashIxs, additionalSigners } = await perpClient.closePosition(params.targetSymbol, params.collateralSymbol, params.priceWithSlippage, params.side, poolConfig, flash_sdk_1.Privilege.None);
+    const collateralToken = poolConfig.getTokenFromSymbol(params.collateralSymbol);
+    const tokenMint = collateralToken.mintKey;
+    const composeParams = {
+        vault,
+        owner: params.owner,
+        vaultId: params.vaultId,
+        agent: params.agent,
+        actionType: { closePosition: {} },
+        tokenMint,
+        amount: params.collateralAmount,
+        targetProtocol: exports.FLASH_TRADE_PROGRAM_ID,
+        defiInstructions: flashIxs,
+        success: true,
+        vaultTokenAccount: params.vaultTokenAccount,
+        feeDestinationTokenAccount: params.feeDestinationTokenAccount,
+    };
+    const instructions = await (0, composer_1.composePermittedAction)(program, composeParams);
+    return { instructions, additionalSigners };
+}
+/**
+ * Compose a Flash Trade increase position through AgentShield.
+ */
+async function composeFlashTradeIncrease(program, perpClient, poolConfig, params) {
+    const [vault] = (0, accounts_1.getVaultPDA)(params.owner, params.vaultId, program.programId);
+    const { instructions: flashIxs, additionalSigners } = await perpClient.increaseSize(params.targetSymbol, params.collateralSymbol, params.positionPubKey, params.side, poolConfig, params.priceWithSlippage, params.sizeDelta, flash_sdk_1.Privilege.None);
+    const collateralToken = poolConfig.getTokenFromSymbol(params.collateralSymbol);
+    const tokenMint = collateralToken.mintKey;
+    const composeParams = {
+        vault,
+        owner: params.owner,
+        vaultId: params.vaultId,
+        agent: params.agent,
+        actionType: { increasePosition: {} },
+        tokenMint,
+        amount: params.collateralAmount,
+        targetProtocol: exports.FLASH_TRADE_PROGRAM_ID,
+        leverageBps: params.leverageBps,
+        defiInstructions: flashIxs,
+        success: true,
+        vaultTokenAccount: params.vaultTokenAccount,
+        feeDestinationTokenAccount: params.feeDestinationTokenAccount,
+    };
+    const instructions = await (0, composer_1.composePermittedAction)(program, composeParams);
+    return { instructions, additionalSigners };
+}
+/**
+ * Compose a Flash Trade decrease position through AgentShield.
+ */
+async function composeFlashTradeDecrease(program, perpClient, poolConfig, params) {
+    const [vault] = (0, accounts_1.getVaultPDA)(params.owner, params.vaultId, program.programId);
+    const { instructions: flashIxs, additionalSigners } = await perpClient.decreaseSize(params.targetSymbol, params.collateralSymbol, params.side, params.positionPubKey, poolConfig, params.priceWithSlippage, params.sizeDelta, flash_sdk_1.Privilege.None);
+    const collateralToken = poolConfig.getTokenFromSymbol(params.collateralSymbol);
+    const tokenMint = collateralToken.mintKey;
+    const composeParams = {
+        vault,
+        owner: params.owner,
+        vaultId: params.vaultId,
+        agent: params.agent,
+        actionType: { decreasePosition: {} },
+        tokenMint,
+        amount: params.collateralAmount,
+        targetProtocol: exports.FLASH_TRADE_PROGRAM_ID,
+        defiInstructions: flashIxs,
+        success: true,
+        vaultTokenAccount: params.vaultTokenAccount,
+        feeDestinationTokenAccount: params.feeDestinationTokenAccount,
+    };
+    const instructions = await (0, composer_1.composePermittedAction)(program, composeParams);
+    return { instructions, additionalSigners };
+}
+/**
+ * Build a complete VersionedTransaction for a Flash Trade operation.
+ * The transaction is NOT signed — caller must sign with the agent keypair
+ * and any additionalSigners.
+ */
+async function composeFlashTradeTransaction(connection, payer, result) {
+    const { blockhash } = await connection.getLatestBlockhash();
+    const messageV0 = new web3_js_1.TransactionMessage({
+        payerKey: payer,
+        recentBlockhash: blockhash,
+        instructions: result.instructions,
+    }).compileToV0Message();
+    return new web3_js_1.VersionedTransaction(messageV0);
+}
+//# sourceMappingURL=flash-trade.js.map

package/dist/integrations/flash-trade.js.map

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

package/dist/integrations/jupiter.d.ts

@@ -0,0 +1,131 @@
+import { PublicKey, TransactionInstruction, VersionedTransaction, Connection, AddressLookupTableAccount } from "@solana/web3.js";
+import { BN, Program } from "@coral-xyz/anchor";
+import type { AgentShield } from "../types";
+export declare const JUPITER_V6_API = "https://quote-api.jup.ag/v6";
+export declare const JUPITER_PROGRAM_ID: PublicKey;
+export declare class JupiterApiError extends Error {
+    readonly statusCode: number;
+    readonly body: string;
+    constructor(statusCode: number, body: string);
+}
+export interface JupiterQuoteParams {
+    inputMint: PublicKey;
+    outputMint: PublicKey;
+    /** Raw token amount (lamports / smallest unit) */
+    amount: BN;
+    /** Slippage in basis points. Default 50 (0.5%) */
+    slippageBps?: number;
+    /** Additional query params forwarded to the Jupiter quote API */
+    extraParams?: Record<string, string>;
+}
+export interface JupiterRoutePlanStep {
+    swapInfo: {
+        ammKey: string;
+        label: string;
+        inputMint: string;
+        outputMint: string;
+        inAmount: string;
+        outAmount: string;
+        feeAmount: string;
+        feeMint: string;
+    };
+    percent: number;
+}
+export interface JupiterQuoteResponse {
+    inputMint: string;
+    inAmount: string;
+    outputMint: string;
+    outAmount: string;
+    otherAmountThreshold: string;
+    swapMode: string;
+    slippageBps: number;
+    priceImpactPct: string;
+    routePlan: JupiterRoutePlanStep[];
+    contextSlot: number;
+    timeTaken: number;
+}
+/** Serialized instruction format returned by Jupiter swap-instructions API */
+export interface JupiterSerializedInstruction {
+    programId: string;
+    accounts: {
+        pubkey: string;
+        isSigner: boolean;
+        isWritable: boolean;
+    }[];
+    data: string;
+}
+export interface JupiterSwapInstructionsResponse {
+    tokenLedgerInstruction?: JupiterSerializedInstruction;
+    computeBudgetInstructions: JupiterSerializedInstruction[];
+    setupInstructions: JupiterSerializedInstruction[];
+    swapInstruction: JupiterSerializedInstruction;
+    cleanupInstruction?: JupiterSerializedInstruction;
+    addressLookupTableAddresses: string[];
+}
+export interface JupiterSwapParams {
+    /** Vault owner pubkey */
+    owner: PublicKey;
+    /** Vault ID (BN) */
+    vaultId: BN;
+    /** Agent signing key */
+    agent: PublicKey;
+    /** Input token mint */
+    inputMint: PublicKey;
+    /** Output token mint */
+    outputMint: PublicKey;
+    /** Amount in smallest units */
+    amount: BN;
+    /** Slippage in bps (default 50) */
+    slippageBps?: number;
+    /** Pre-fetched quote — skips the quote API call if provided */
+    quote?: JupiterQuoteResponse;
+    /** Optional: vault token account for fee deduction */
+    vaultTokenAccount?: PublicKey | null;
+    /** Optional: fee destination token account */
+    feeDestinationTokenAccount?: PublicKey | null;
+}
+/**
+ * Deserialize a Jupiter serialized instruction into a Solana TransactionInstruction.
+ */
+export declare function deserializeInstruction(ix: JupiterSerializedInstruction): TransactionInstruction;
+/**
+ * Fetch a swap quote from the Jupiter V6 API.
+ */
+export declare function fetchJupiterQuote(params: JupiterQuoteParams): Promise<JupiterQuoteResponse>;
+/**
+ * Fetch deserialized swap instructions from Jupiter V6 API.
+ *
+ * @param quote - A quote previously obtained from `fetchJupiterQuote`.
+ * @param userPublicKey - The account that owns the input tokens. For
+ *   AgentShield, this should be the **vault PDA** (the vault owns the ATAs).
+ */
+export declare function fetchJupiterSwapInstructions(quote: JupiterQuoteResponse, userPublicKey: PublicKey): Promise<JupiterSwapInstructionsResponse>;
+/**
+ * Fetch address lookup table accounts for a set of table addresses.
+ */
+export declare function fetchAddressLookupTables(connection: Connection, tableAddresses: string[]): Promise<AddressLookupTableAccount[]>;
+/**
+ * Build a full AgentShield-composed Jupiter swap transaction.
+ *
+ * Returns an array of TransactionInstructions:
+ * `[ComputeBudget, ValidateAndAuthorize, ...setupIxs, swapIx, cleanupIx?, FinalizeSession]`
+ *
+ * The DeFi instructions (setup + swap + cleanup) are sandwiched between
+ * validate and finalize, forming an atomic composed transaction.
+ *
+ * @param program - The AgentShield Anchor program instance.
+ * @param connection - Solana connection (needed for address lookup tables).
+ * @param params - Jupiter swap parameters including vault/agent info.
+ * @returns Instructions array + address lookup tables for VersionedTransaction.
+ */
+export declare function composeJupiterSwap(program: Program<AgentShield>, connection: Connection, params: JupiterSwapParams): Promise<{
+    instructions: TransactionInstruction[];
+    addressLookupTables: AddressLookupTableAccount[];
+}>;
+/**
+ * Build a complete VersionedTransaction for a Jupiter swap through AgentShield.
+ *
+ * The transaction is NOT signed — caller must sign with the agent keypair.
+ */
+export declare function composeJupiterSwapTransaction(program: Program<AgentShield>, connection: Connection, params: JupiterSwapParams): Promise<VersionedTransaction>;
+//# sourceMappingURL=jupiter.d.ts.map

package/dist/integrations/jupiter.d.ts.map

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