@agent-shield/sdk 0.1.0

package/dist/idl.d.ts

@@ -0,0 +1,2475 @@
+/**
+ * Program IDL in camelCase format in order to be used in JS/TS.
+ *
+ * Note that this is only a type helper and is not the actual IDL. The original
+ * IDL can be found at `target/idl/agent_shield.json`.
+ */
+export type AgentShield = {
+    "address": "4ZeVCqnjUgUtFrHHPG7jELUxvJeoVGHhGNgPrhBPwrHL";
+    "metadata": {
+        "name": "agentShield";
+        "version": "0.1.0";
+        "spec": "0.1.0";
+        "description": "AI Agent Financial Middleware for Solana - Permission controls, spending limits, and audit infrastructure for autonomous agents";
+    };
+    "instructions": [
+        {
+            "name": "closeVault";
+            "docs": [
+                "Close the vault entirely. Withdraws all remaining funds and closes all PDAs.",
+                "Reclaims rent. Vault must have no open positions. Only the owner can call this."
+            ];
+            "discriminator": [
+                141,
+                103,
+                17,
+                126,
+                72,
+                75,
+                29,
+                29
+            ];
+            "accounts": [
+                {
+                    "name": "owner";
+                    "writable": true;
+                    "signer": true;
+                    "relations": [
+                        "vault"
+                    ];
+                },
+                {
+                    "name": "vault";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    118,
+                                    97,
+                                    117,
+                                    108,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "owner";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault.vault_id";
+                                "account": "agentVault";
+                            }
+                        ];
+                    };
+                    "relations": [
+                        "policy",
+                        "tracker"
+                    ];
+                },
+                {
+                    "name": "policy";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    112,
+                                    111,
+                                    108,
+                                    105,
+                                    99,
+                                    121
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "tracker";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    116,
+                                    114,
+                                    97,
+                                    99,
+                                    107,
+                                    101,
+                                    114
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "depositFunds";
+            "docs": [
+                "Deposit SPL tokens into the vault's PDA-controlled token account.",
+                "Only the owner can call this."
+            ];
+            "discriminator": [
+                202,
+                39,
+                52,
+                211,
+                53,
+                20,
+                250,
+                88
+            ];
+            "accounts": [
+                {
+                    "name": "owner";
+                    "writable": true;
+                    "signer": true;
+                    "relations": [
+                        "vault"
+                    ];
+                },
+                {
+                    "name": "vault";
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    118,
+                                    97,
+                                    117,
+                                    108,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "owner";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault.vault_id";
+                                "account": "agentVault";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "mint";
+                },
+                {
+                    "name": "ownerTokenAccount";
+                    "docs": [
+                        "Owner's token account to transfer from"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "account";
+                                "path": "owner";
+                            },
+                            {
+                                "kind": "const";
+                                "value": [
+                                    6,
+                                    221,
+                                    246,
+                                    225,
+                                    215,
+                                    101,
+                                    161,
+                                    147,
+                                    217,
+                                    203,
+                                    225,
+                                    70,
+                                    206,
+                                    235,
+                                    121,
+                                    172,
+                                    28,
+                                    180,
+                                    133,
+                                    237,
+                                    95,
+                                    91,
+                                    55,
+                                    145,
+                                    58,
+                                    140,
+                                    245,
+                                    133,
+                                    126,
+                                    255,
+                                    0,
+                                    169
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "mint";
+                            }
+                        ];
+                        "program": {
+                            "kind": "const";
+                            "value": [
+                                140,
+                                151,
+                                37,
+                                143,
+                                78,
+                                36,
+                                137,
+                                241,
+                                187,
+                                61,
+                                16,
+                                41,
+                                20,
+                                142,
+                                13,
+                                131,
+                                11,
+                                90,
+                                19,
+                                153,
+                                218,
+                                255,
+                                16,
+                                132,
+                                4,
+                                142,
+                                123,
+                                216,
+                                219,
+                                233,
+                                248,
+                                89
+                            ];
+                        };
+                    };
+                },
+                {
+                    "name": "vaultTokenAccount";
+                    "docs": [
+                        "Vault's PDA-controlled token account"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "account";
+                                "path": "vault";
+                            },
+                            {
+                                "kind": "const";
+                                "value": [
+                                    6,
+                                    221,
+                                    246,
+                                    225,
+                                    215,
+                                    101,
+                                    161,
+                                    147,
+                                    217,
+                                    203,
+                                    225,
+                                    70,
+                                    206,
+                                    235,
+                                    121,
+                                    172,
+                                    28,
+                                    180,
+                                    133,
+                                    237,
+                                    95,
+                                    91,
+                                    55,
+                                    145,
+                                    58,
+                                    140,
+                                    245,
+                                    133,
+                                    126,
+                                    255,
+                                    0,
+                                    169
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "mint";
+                            }
+                        ];
+                        "program": {
+                            "kind": "const";
+                            "value": [
+                                140,
+                                151,
+                                37,
+                                143,
+                                78,
+                                36,
+                                137,
+                                241,
+                                187,
+                                61,
+                                16,
+                                41,
+                                20,
+                                142,
+                                13,
+                                131,
+                                11,
+                                90,
+                                19,
+                                153,
+                                218,
+                                255,
+                                16,
+                                132,
+                                4,
+                                142,
+                                123,
+                                216,
+                                219,
+                                233,
+                                248,
+                                89
+                            ];
+                        };
+                    };
+                },
+                {
+                    "name": "tokenProgram";
+                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+                },
+                {
+                    "name": "associatedTokenProgram";
+                    "address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [
+                {
+                    "name": "amount";
+                    "type": "u64";
+                }
+            ];
+        },
+        {
+            "name": "finalizeSession";
+            "docs": [
+                "Finalize a session after the DeFi action completes.",
+                "Closes the SessionAuthority PDA and records the transaction in the audit log.",
+                "Can be called by the agent or permissionlessly (for cleanup of expired sessions)."
+            ];
+            "discriminator": [
+                34,
+                148,
+                144,
+                47,
+                37,
+                130,
+                206,
+                161
+            ];
+            "accounts": [
+                {
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "vault";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    118,
+                                    97,
+                                    117,
+                                    108,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault.owner";
+                                "account": "agentVault";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault.vault_id";
+                                "account": "agentVault";
+                            }
+                        ];
+                    };
+                    "relations": [
+                        "policy",
+                        "tracker",
+                        "session"
+                    ];
+                },
+                {
+                    "name": "policy";
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    112,
+                                    111,
+                                    108,
+                                    105,
+                                    99,
+                                    121
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "tracker";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    116,
+                                    114,
+                                    97,
+                                    99,
+                                    107,
+                                    101,
+                                    114
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "session";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    115,
+                                    101,
+                                    115,
+                                    115,
+                                    105,
+                                    111,
+                                    110
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "session.agent";
+                                "account": "sessionAuthority";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "vaultTokenAccount";
+                    "docs": [
+                        "Vault's PDA token account for the session's token (fee source)"
+                    ];
+                    "writable": true;
+                    "optional": true;
+                },
+                {
+                    "name": "feeDestinationTokenAccount";
+                    "docs": [
+                        "Fee destination token account — must match vault.fee_destination"
+                    ];
+                    "writable": true;
+                    "optional": true;
+                },
+                {
+                    "name": "tokenProgram";
+                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [
+                {
+                    "name": "success";
+                    "type": "bool";
+                }
+            ];
+        },
+        {
+            "name": "initializeVault";
+            "docs": [
+                "Initialize a new agent vault with policy configuration.",
+                "Only the owner can call this. Creates vault PDA, policy PDA, and spend tracker PDA."
+            ];
+            "discriminator": [
+                48,
+                191,
+                163,
+                44,
+                71,
+                129,
+                63,
+                164
+            ];
+            "accounts": [
+                {
+                    "name": "owner";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "vault";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    118,
+                                    97,
+                                    117,
+                                    108,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "owner";
+                            },
+                            {
+                                "kind": "arg";
+                                "path": "vaultId";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "policy";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    112,
+                                    111,
+                                    108,
+                                    105,
+                                    99,
+                                    121
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "tracker";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    116,
+                                    114,
+                                    97,
+                                    99,
+                                    107,
+                                    101,
+                                    114
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "feeDestination";
+                    "docs": [
+                        "The protocol treasury that receives fees"
+                    ];
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [
+                {
+                    "name": "vaultId";
+                    "type": "u64";
+                },
+                {
+                    "name": "dailySpendingCap";
+                    "type": "u64";
+                },
+                {
+                    "name": "maxTransactionSize";
+                    "type": "u64";
+                },
+                {
+                    "name": "allowedTokens";
+                    "type": {
+                        "vec": "pubkey";
+                    };
+                },
+                {
+                    "name": "allowedProtocols";
+                    "type": {
+                        "vec": "pubkey";
+                    };
+                },
+                {
+                    "name": "maxLeverageBps";
+                    "type": "u16";
+                },
+                {
+                    "name": "maxConcurrentPositions";
+                    "type": "u8";
+                }
+            ];
+        },
+        {
+            "name": "reactivateVault";
+            "docs": [
+                "Reactivate a frozen vault. Optionally rotate the agent key.",
+                "Only the owner can call this."
+            ];
+            "discriminator": [
+                245,
+                50,
+                143,
+                70,
+                114,
+                220,
+                25,
+                251
+            ];
+            "accounts": [
+                {
+                    "name": "owner";
+                    "signer": true;
+                    "relations": [
+                        "vault"
+                    ];
+                },
+                {
+                    "name": "vault";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    118,
+                                    97,
+                                    117,
+                                    108,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "owner";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault.vault_id";
+                                "account": "agentVault";
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [
+                {
+                    "name": "newAgent";
+                    "type": {
+                        "option": "pubkey";
+                    };
+                }
+            ];
+        },
+        {
+            "name": "registerAgent";
+            "docs": [
+                "Register an agent's signing key to this vault.",
+                "Only the owner can call this. One agent per vault."
+            ];
+            "discriminator": [
+                135,
+                157,
+                66,
+                195,
+                2,
+                113,
+                175,
+                30
+            ];
+            "accounts": [
+                {
+                    "name": "owner";
+                    "signer": true;
+                    "relations": [
+                        "vault"
+                    ];
+                },
+                {
+                    "name": "vault";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    118,
+                                    97,
+                                    117,
+                                    108,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "owner";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault.vault_id";
+                                "account": "agentVault";
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [
+                {
+                    "name": "agent";
+                    "type": "pubkey";
+                }
+            ];
+        },
+        {
+            "name": "revokeAgent";
+            "docs": [
+                "Kill switch. Immediately freezes the vault, preventing all agent actions.",
+                "Only the owner can call this. Funds can still be withdrawn by the owner."
+            ];
+            "discriminator": [
+                227,
+                60,
+                209,
+                125,
+                240,
+                117,
+                163,
+                73
+            ];
+            "accounts": [
+                {
+                    "name": "owner";
+                    "signer": true;
+                    "relations": [
+                        "vault"
+                    ];
+                },
+                {
+                    "name": "vault";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    118,
+                                    97,
+                                    117,
+                                    108,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "owner";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault.vault_id";
+                                "account": "agentVault";
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "updatePolicy";
+            "docs": [
+                "Update the policy configuration for a vault.",
+                "Only the owner can call this. Cannot be called by the agent."
+            ];
+            "discriminator": [
+                212,
+                245,
+                246,
+                7,
+                163,
+                151,
+                18,
+                57
+            ];
+            "accounts": [
+                {
+                    "name": "owner";
+                    "signer": true;
+                    "relations": [
+                        "vault"
+                    ];
+                },
+                {
+                    "name": "vault";
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    118,
+                                    97,
+                                    117,
+                                    108,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "owner";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault.vault_id";
+                                "account": "agentVault";
+                            }
+                        ];
+                    };
+                    "relations": [
+                        "policy"
+                    ];
+                },
+                {
+                    "name": "policy";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    112,
+                                    111,
+                                    108,
+                                    105,
+                                    99,
+                                    121
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault";
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [
+                {
+                    "name": "dailySpendingCap";
+                    "type": {
+                        "option": "u64";
+                    };
+                },
+                {
+                    "name": "maxTransactionSize";
+                    "type": {
+                        "option": "u64";
+                    };
+                },
+                {
+                    "name": "allowedTokens";
+                    "type": {
+                        "option": {
+                            "vec": "pubkey";
+                        };
+                    };
+                },
+                {
+                    "name": "allowedProtocols";
+                    "type": {
+                        "option": {
+                            "vec": "pubkey";
+                        };
+                    };
+                },
+                {
+                    "name": "maxLeverageBps";
+                    "type": {
+                        "option": "u16";
+                    };
+                },
+                {
+                    "name": "canOpenPositions";
+                    "type": {
+                        "option": "bool";
+                    };
+                },
+                {
+                    "name": "maxConcurrentPositions";
+                    "type": {
+                        "option": "u8";
+                    };
+                }
+            ];
+        },
+        {
+            "name": "validateAndAuthorize";
+            "docs": [
+                "Core permission check. Called by the agent before a DeFi action.",
+                "Validates the action against all policy constraints.",
+                "If approved, creates a SessionAuthority PDA and updates spend tracking.",
+                "If denied, reverts the entire transaction (including subsequent DeFi instructions)."
+            ];
+            "discriminator": [
+                22,
+                183,
+                48,
+                222,
+                218,
+                11,
+                197,
+                152
+            ];
+            "accounts": [
+                {
+                    "name": "agent";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "vault";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    118,
+                                    97,
+                                    117,
+                                    108,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault.owner";
+                                "account": "agentVault";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault.vault_id";
+                                "account": "agentVault";
+                            }
+                        ];
+                    };
+                    "relations": [
+                        "policy",
+                        "tracker"
+                    ];
+                },
+                {
+                    "name": "policy";
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    112,
+                                    111,
+                                    108,
+                                    105,
+                                    99,
+                                    121
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "tracker";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    116,
+                                    114,
+                                    97,
+                                    99,
+                                    107,
+                                    101,
+                                    114
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "session";
+                    "docs": [
+                        "Ephemeral session PDA — `init` ensures no double-authorization"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    115,
+                                    101,
+                                    115,
+                                    115,
+                                    105,
+                                    111,
+                                    110
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "agent";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [
+                {
+                    "name": "actionType";
+                    "type": {
+                        "defined": {
+                            "name": "actionType";
+                        };
+                    };
+                },
+                {
+                    "name": "tokenMint";
+                    "type": "pubkey";
+                },
+                {
+                    "name": "amount";
+                    "type": "u64";
+                },
+                {
+                    "name": "targetProtocol";
+                    "type": "pubkey";
+                },
+                {
+                    "name": "leverageBps";
+                    "type": {
+                        "option": "u16";
+                    };
+                }
+            ];
+        },
+        {
+            "name": "withdrawFunds";
+            "docs": [
+                "Withdraw tokens from the vault back to the owner.",
+                "Works in any vault status (Active or Frozen). Only the owner can call this."
+            ];
+            "discriminator": [
+                241,
+                36,
+                29,
+                111,
+                208,
+                31,
+                104,
+                217
+            ];
+            "accounts": [
+                {
+                    "name": "owner";
+                    "writable": true;
+                    "signer": true;
+                    "relations": [
+                        "vault"
+                    ];
+                },
+                {
+                    "name": "vault";
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    118,
+                                    97,
+                                    117,
+                                    108,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "owner";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "vault.vault_id";
+                                "account": "agentVault";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "mint";
+                },
+                {
+                    "name": "vaultTokenAccount";
+                    "docs": [
+                        "Vault's PDA-controlled token account"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "account";
+                                "path": "vault";
+                            },
+                            {
+                                "kind": "const";
+                                "value": [
+                                    6,
+                                    221,
+                                    246,
+                                    225,
+                                    215,
+                                    101,
+                                    161,
+                                    147,
+                                    217,
+                                    203,
+                                    225,
+                                    70,
+                                    206,
+                                    235,
+                                    121,
+                                    172,
+                                    28,
+                                    180,
+                                    133,
+                                    237,
+                                    95,
+                                    91,
+                                    55,
+                                    145,
+                                    58,
+                                    140,
+                                    245,
+                                    133,
+                                    126,
+                                    255,
+                                    0,
+                                    169
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "mint";
+                            }
+                        ];
+                        "program": {
+                            "kind": "const";
+                            "value": [
+                                140,
+                                151,
+                                37,
+                                143,
+                                78,
+                                36,
+                                137,
+                                241,
+                                187,
+                                61,
+                                16,
+                                41,
+                                20,
+                                142,
+                                13,
+                                131,
+                                11,
+                                90,
+                                19,
+                                153,
+                                218,
+                                255,
+                                16,
+                                132,
+                                4,
+                                142,
+                                123,
+                                216,
+                                219,
+                                233,
+                                248,
+                                89
+                            ];
+                        };
+                    };
+                },
+                {
+                    "name": "ownerTokenAccount";
+                    "docs": [
+                        "Owner's token account to receive funds"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "account";
+                                "path": "owner";
+                            },
+                            {
+                                "kind": "const";
+                                "value": [
+                                    6,
+                                    221,
+                                    246,
+                                    225,
+                                    215,
+                                    101,
+                                    161,
+                                    147,
+                                    217,
+                                    203,
+                                    225,
+                                    70,
+                                    206,
+                                    235,
+                                    121,
+                                    172,
+                                    28,
+                                    180,
+                                    133,
+                                    237,
+                                    95,
+                                    91,
+                                    55,
+                                    145,
+                                    58,
+                                    140,
+                                    245,
+                                    133,
+                                    126,
+                                    255,
+                                    0,
+                                    169
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "mint";
+                            }
+                        ];
+                        "program": {
+                            "kind": "const";
+                            "value": [
+                                140,
+                                151,
+                                37,
+                                143,
+                                78,
+                                36,
+                                137,
+                                241,
+                                187,
+                                61,
+                                16,
+                                41,
+                                20,
+                                142,
+                                13,
+                                131,
+                                11,
+                                90,
+                                19,
+                                153,
+                                218,
+                                255,
+                                16,
+                                132,
+                                4,
+                                142,
+                                123,
+                                216,
+                                219,
+                                233,
+                                248,
+                                89
+                            ];
+                        };
+                    };
+                },
+                {
+                    "name": "tokenProgram";
+                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+                }
+            ];
+            "args": [
+                {
+                    "name": "amount";
+                    "type": "u64";
+                }
+            ];
+        }
+    ];
+    "accounts": [
+        {
+            "name": "agentVault";
+            "discriminator": [
+                232,
+                220,
+                237,
+                164,
+                157,
+                9,
+                215,
+                194
+            ];
+        },
+        {
+            "name": "policyConfig";
+            "discriminator": [
+                219,
+                7,
+                79,
+                84,
+                175,
+                51,
+                148,
+                146
+            ];
+        },
+        {
+            "name": "sessionAuthority";
+            "discriminator": [
+                48,
+                9,
+                30,
+                120,
+                134,
+                35,
+                172,
+                170
+            ];
+        },
+        {
+            "name": "spendTracker";
+            "discriminator": [
+                180,
+                17,
+                195,
+                180,
+                162,
+                207,
+                239,
+                205
+            ];
+        }
+    ];
+    "events": [
+        {
+            "name": "actionAuthorized";
+            "discriminator": [
+                85,
+                90,
+                59,
+                218,
+                126,
+                8,
+                179,
+                63
+            ];
+        },
+        {
+            "name": "actionDenied";
+            "discriminator": [
+                243,
+                239,
+                240,
+                51,
+                151,
+                100,
+                10,
+                100
+            ];
+        },
+        {
+            "name": "agentRegistered";
+            "discriminator": [
+                191,
+                78,
+                217,
+                54,
+                232,
+                100,
+                189,
+                85
+            ];
+        },
+        {
+            "name": "agentRevoked";
+            "discriminator": [
+                12,
+                251,
+                249,
+                166,
+                122,
+                83,
+                162,
+                116
+            ];
+        },
+        {
+            "name": "feesCollected";
+            "discriminator": [
+                233,
+                23,
+                117,
+                225,
+                107,
+                178,
+                254,
+                8
+            ];
+        },
+        {
+            "name": "fundsDeposited";
+            "discriminator": [
+                157,
+                209,
+                100,
+                95,
+                59,
+                100,
+                3,
+                68
+            ];
+        },
+        {
+            "name": "fundsWithdrawn";
+            "discriminator": [
+                56,
+                130,
+                230,
+                154,
+                35,
+                92,
+                11,
+                118
+            ];
+        },
+        {
+            "name": "policyUpdated";
+            "discriminator": [
+                225,
+                112,
+                112,
+                67,
+                95,
+                236,
+                245,
+                161
+            ];
+        },
+        {
+            "name": "sessionFinalized";
+            "discriminator": [
+                33,
+                12,
+                242,
+                91,
+                206,
+                42,
+                163,
+                235
+            ];
+        },
+        {
+            "name": "vaultClosed";
+            "discriminator": [
+                238,
+                129,
+                38,
+                228,
+                227,
+                118,
+                249,
+                215
+            ];
+        },
+        {
+            "name": "vaultCreated";
+            "discriminator": [
+                117,
+                25,
+                120,
+                254,
+                75,
+                236,
+                78,
+                115
+            ];
+        },
+        {
+            "name": "vaultReactivated";
+            "discriminator": [
+                197,
+                52,
+                160,
+                147,
+                159,
+                89,
+                90,
+                28
+            ];
+        }
+    ];
+    "errors": [
+        {
+            "code": 6000;
+            "name": "vaultNotActive";
+            "msg": "Vault is not active";
+        },
+        {
+            "code": 6001;
+            "name": "unauthorizedAgent";
+            "msg": "Unauthorized: signer is not the registered agent";
+        },
+        {
+            "code": 6002;
+            "name": "unauthorizedOwner";
+            "msg": "Unauthorized: signer is not the vault owner";
+        },
+        {
+            "code": 6003;
+            "name": "tokenNotAllowed";
+            "msg": "Token not in allowed list";
+        },
+        {
+            "code": 6004;
+            "name": "protocolNotAllowed";
+            "msg": "Protocol not in allowed list";
+        },
+        {
+            "code": 6005;
+            "name": "transactionTooLarge";
+            "msg": "Transaction exceeds maximum single transaction size";
+        },
+        {
+            "code": 6006;
+            "name": "dailyCapExceeded";
+            "msg": "Daily spending cap would be exceeded";
+        },
+        {
+            "code": 6007;
+            "name": "leverageTooHigh";
+            "msg": "Leverage exceeds maximum allowed";
+        },
+        {
+            "code": 6008;
+            "name": "tooManyPositions";
+            "msg": "Maximum concurrent open positions reached";
+        },
+        {
+            "code": 6009;
+            "name": "positionOpeningDisallowed";
+            "msg": "Cannot open new positions (policy disallows)";
+        },
+        {
+            "code": 6010;
+            "name": "sessionExpired";
+            "msg": "Session has expired";
+        },
+        {
+            "code": 6011;
+            "name": "sessionNotAuthorized";
+            "msg": "Session not authorized";
+        },
+        {
+            "code": 6012;
+            "name": "invalidSession";
+            "msg": "Invalid session: does not belong to this vault";
+        },
+        {
+            "code": 6013;
+            "name": "openPositionsExist";
+            "msg": "Vault has open positions, cannot close";
+        },
+        {
+            "code": 6014;
+            "name": "tooManyAllowedTokens";
+            "msg": "Policy configuration invalid: too many allowed tokens";
+        },
+        {
+            "code": 6015;
+            "name": "tooManyAllowedProtocols";
+            "msg": "Policy configuration invalid: too many allowed protocols";
+        },
+        {
+            "code": 6016;
+            "name": "agentAlreadyRegistered";
+            "msg": "Agent already registered for this vault";
+        },
+        {
+            "code": 6017;
+            "name": "noAgentRegistered";
+            "msg": "No agent registered for this vault";
+        },
+        {
+            "code": 6018;
+            "name": "vaultNotFrozen";
+            "msg": "Vault is not frozen (expected frozen for reactivation)";
+        },
+        {
+            "code": 6019;
+            "name": "vaultAlreadyClosed";
+            "msg": "Vault is already closed";
+        },
+        {
+            "code": 6020;
+            "name": "insufficientBalance";
+            "msg": "Insufficient vault balance for withdrawal";
+        },
+        {
+            "code": 6021;
+            "name": "feeBpsTooHigh";
+            "msg": "Fee basis points exceed maximum (500 bps / 5%)";
+        },
+        {
+            "code": 6022;
+            "name": "invalidFeeDestination";
+            "msg": "Fee destination account invalid";
+        },
+        {
+            "code": 6023;
+            "name": "overflow";
+            "msg": "Arithmetic overflow";
+        }
+    ];
+    "types": [
+        {
+            "name": "actionAuthorized";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "agent";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "actionType";
+                        "type": {
+                            "defined": {
+                                "name": "actionType";
+                            };
+                        };
+                    },
+                    {
+                        "name": "tokenMint";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "amount";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "protocol";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "rollingSpendAfter";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "dailyCap";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "actionDenied";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "agent";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "reason";
+                        "type": "string";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "actionType";
+            "docs": [
+                "Action types that agents can request"
+            ];
+            "type": {
+                "kind": "enum";
+                "variants": [
+                    {
+                        "name": "swap";
+                    },
+                    {
+                        "name": "openPosition";
+                    },
+                    {
+                        "name": "closePosition";
+                    },
+                    {
+                        "name": "increasePosition";
+                    },
+                    {
+                        "name": "decreasePosition";
+                    },
+                    {
+                        "name": "deposit";
+                    },
+                    {
+                        "name": "withdraw";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "agentRegistered";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "agent";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "agentRevoked";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "agent";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "agentVault";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "owner";
+                        "docs": [
+                            "The owner who created this vault (has full authority)"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "agent";
+                        "docs": [
+                            "The registered agent's signing key (Pubkey::default() if not yet registered)"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "feeDestination";
+                        "docs": [
+                            "Protocol fee destination — the AgentShield treasury wallet that receives",
+                            "basis-point fees on every finalized transaction. Set at vault creation,",
+                            "immutable after initialization."
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "vaultId";
+                        "docs": [
+                            "Unique vault identifier (allows one owner to have multiple vaults)"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "status";
+                        "docs": [
+                            "Vault status: Active, Frozen, or Closed"
+                        ];
+                        "type": {
+                            "defined": {
+                                "name": "vaultStatus";
+                            };
+                        };
+                    },
+                    {
+                        "name": "bump";
+                        "docs": [
+                            "Bump seed for PDA derivation"
+                        ];
+                        "type": "u8";
+                    },
+                    {
+                        "name": "createdAt";
+                        "docs": [
+                            "Unix timestamp of vault creation"
+                        ];
+                        "type": "i64";
+                    },
+                    {
+                        "name": "totalTransactions";
+                        "docs": [
+                            "Total number of agent transactions executed through this vault"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "totalVolume";
+                        "docs": [
+                            "Total volume processed in token base units"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "openPositions";
+                        "docs": [
+                            "Number of currently open positions (for perps tracking)"
+                        ];
+                        "type": "u8";
+                    },
+                    {
+                        "name": "totalFeesCollected";
+                        "docs": [
+                            "Cumulative protocol fees collected from this vault (token base units)"
+                        ];
+                        "type": "u64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "feesCollected";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "tokenMint";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "feeAmount";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "feeBps";
+                        "type": "u16";
+                    },
+                    {
+                        "name": "transactionAmount";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "feeDestination";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "cumulativeFees";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "fundsDeposited";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "tokenMint";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "amount";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "fundsWithdrawn";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "tokenMint";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "amount";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "destination";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "policyConfig";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "docs": [
+                            "Associated vault pubkey"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "dailySpendingCap";
+                        "docs": [
+                            "Maximum spend per rolling 24h period (in token base units)"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "maxTransactionSize";
+                        "docs": [
+                            "Maximum single transaction size (in token base units)"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "allowedTokens";
+                        "docs": [
+                            "Allowed token mints the agent can interact with",
+                            "Bounded to MAX_ALLOWED_TOKENS entries"
+                        ];
+                        "type": {
+                            "vec": "pubkey";
+                        };
+                    },
+                    {
+                        "name": "allowedProtocols";
+                        "docs": [
+                            "Allowed program IDs the agent can call (Jupiter, Flash Trade, etc.)",
+                            "Bounded to MAX_ALLOWED_PROTOCOLS entries"
+                        ];
+                        "type": {
+                            "vec": "pubkey";
+                        };
+                    },
+                    {
+                        "name": "maxLeverageBps";
+                        "docs": [
+                            "Maximum leverage multiplier in basis points (e.g., 10000 = 100x, 1000 = 10x)",
+                            "Set to 0 to disallow leveraged positions entirely"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "canOpenPositions";
+                        "docs": [
+                            "Whether the agent can open new positions (vs only close existing)"
+                        ];
+                        "type": "bool";
+                    },
+                    {
+                        "name": "maxConcurrentPositions";
+                        "docs": [
+                            "Maximum number of concurrent open positions"
+                        ];
+                        "type": "u8";
+                    },
+                    {
+                        "name": "feeBps";
+                        "docs": [
+                            "Protocol fee in basis points (1 bps = 0.01%). Applied to every finalized",
+                            "transaction. Fee deducted from vault, transferred to fee_destination.",
+                            "Max MAX_FEE_BPS (500 = 5%). Set to 0 for no fee."
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "bump";
+                        "docs": [
+                            "Bump seed for PDA"
+                        ];
+                        "type": "u8";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "policyUpdated";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "dailyCap";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "maxTransactionSize";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "allowedTokensCount";
+                        "type": "u8";
+                    },
+                    {
+                        "name": "allowedProtocolsCount";
+                        "type": "u8";
+                    },
+                    {
+                        "name": "maxLeverageBps";
+                        "type": "u16";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "sessionAuthority";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "docs": [
+                            "Associated vault"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "agent";
+                        "docs": [
+                            "The agent who initiated this session"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "authorized";
+                        "docs": [
+                            "Whether this session has been authorized by the permission check"
+                        ];
+                        "type": "bool";
+                    },
+                    {
+                        "name": "authorizedAmount";
+                        "docs": [
+                            "Authorized action details (for verification in finalize)"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "authorizedToken";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "authorizedProtocol";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "expiresAtSlot";
+                        "docs": [
+                            "Slot-based expiry: session is valid until this slot"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "bump";
+                        "docs": [
+                            "Bump seed for PDA"
+                        ];
+                        "type": "u8";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "sessionFinalized";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "agent";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "success";
+                        "type": "bool";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "spendEntry";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "tokenMint";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "amountSpent";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "spendTracker";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "docs": [
+                            "Associated vault pubkey"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "rollingSpends";
+                        "docs": [
+                            "Rolling spend entries: (token_mint, amount, timestamp)",
+                            "Entries older than ROLLING_WINDOW_SECONDS are pruned on each access"
+                        ];
+                        "type": {
+                            "vec": {
+                                "defined": {
+                                    "name": "spendEntry";
+                                };
+                            };
+                        };
+                    },
+                    {
+                        "name": "recentTransactions";
+                        "docs": [
+                            "Recent transaction log for on-chain audit trail",
+                            "Bounded to MAX_RECENT_TRANSACTIONS, oldest entries evicted (ring buffer)"
+                        ];
+                        "type": {
+                            "vec": {
+                                "defined": {
+                                    "name": "transactionRecord";
+                                };
+                            };
+                        };
+                    },
+                    {
+                        "name": "bump";
+                        "docs": [
+                            "Bump seed for PDA"
+                        ];
+                        "type": "u8";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "transactionRecord";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    },
+                    {
+                        "name": "actionType";
+                        "type": {
+                            "defined": {
+                                "name": "actionType";
+                            };
+                        };
+                    },
+                    {
+                        "name": "tokenMint";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "amount";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "protocol";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "success";
+                        "type": "bool";
+                    },
+                    {
+                        "name": "slot";
+                        "type": "u64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "vaultClosed";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "owner";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "vaultCreated";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "owner";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "vaultId";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "vaultReactivated";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "vault";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "newAgent";
+                        "type": {
+                            "option": "pubkey";
+                        };
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "vaultStatus";
+            "docs": [
+                "Vault status enum"
+            ];
+            "type": {
+                "kind": "enum";
+                "variants": [
+                    {
+                        "name": "active";
+                    },
+                    {
+                        "name": "frozen";
+                    },
+                    {
+                        "name": "closed";
+                    }
+                ];
+            };
+        }
+    ];
+};
+//# sourceMappingURL=idl.d.ts.map