@enshell/sdk 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ENShell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# ENShell SDK
+
+[![codecov](https://codecov.io/gh/0xenshell/sdk/graph/badge.svg?token=W8JIFQD4P0)](https://codecov.io/gh/0xenshell/sdk)
+
+Core SDK for **ENShell**, an on-chain firewall for AI agents. Provides a typed client to register agents, submit actions through the firewall, manage target permissions, and handle Ledger approvals. Built on ethers.js v6.
+
+## Setup
+
+Requires Node.js >= 22.10.0.
+
+```bash
+npm install @enshell/sdk
+```
+
+## Usage
+
+```typescript
+import { ENShell, Network } from "@enshell/sdk";
+import { Wallet, JsonRpcProvider } from "ethers";
+
+const provider = new JsonRpcProvider("https://rpc.sepolia.org");
+const signer = new Wallet(process.env.PRIVATE_KEY!, provider);
+
+const enshell = new ENShell({
+  network: Network.SEPOLIA,
+  signer,
+  contractAddress: "0x...",
+});
+
+// Register an agent
+await enshell.registerAgent("my-agent", {
+  ensNode: "0x...",
+  agentAddress: "0x...",
+  spendLimit: "0.1",
+  allowedTargets: ["0x..."],
+});
+
+// Submit an action through the firewall
+const result = await enshell.submitAction(
+  "my-agent",
+  "0x...",  // target
+  "0.05",  // value in ETH
+  "0x",    // calldata
+  "Send 0.05 ETH to treasury",
+);
+```
+
+## Development
+
+### Build
+
+```bash
+npm run build
+```
+
+### Test
+
+```bash
+npm test
+```
+
+### Coverage
+
+```bash
+npm run test:coverage
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,18 @@
+import type { ENShellConfig, Agent, RegisterAgentOptions, ActionResult, QueuedAction } from "./types.js";
+export declare class ENShell {
+    private contract;
+    private config;
+    constructor(config: ENShellConfig);
+    registerAgent(agentId: string, options: RegisterAgentOptions): Promise<void>;
+    getAgent(agentId: string): Promise<Agent>;
+    getAgentCount(): Promise<bigint>;
+    deactivateAgent(agentId: string): Promise<void>;
+    reactivateAgent(agentId: string): Promise<void>;
+    setAllowedTarget(agentId: string, target: string, allowed: boolean): Promise<void>;
+    isTargetAllowed(agentId: string, target: string): Promise<boolean>;
+    submitAction(agentId: string, target: string, value: string, data: string, instruction: string): Promise<ActionResult>;
+    approveAction(actionId: bigint): Promise<void>;
+    rejectAction(actionId: bigint): Promise<void>;
+    getQueuedAction(actionId: bigint): Promise<QueuedAction>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,KAAK,EACL,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAC;AAGpB,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,aAAa;IAkB3B,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAmBV,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAczC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAIhC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/C,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;IAKV,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMlE,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC;IAkClB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7C,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAa/D"}

package/dist/client.js

@@ -0,0 +1,105 @@
+import { parseEther } from "ethers";
+import { getFirewallContract } from "./contract.js";
+import { NETWORK_CONFIG } from "./networks.js";
+import { ActionStatus } from "./types.js";
+export class ENShell {
+    contract;
+    config;
+    constructor(config) {
+        this.config = config;
+        const address = config.contractAddress ??
+            NETWORK_CONFIG[config.network].firewallAddress;
+        if (!address) {
+            throw new Error(`No contract address configured for network ${config.network}`);
+        }
+        this.contract = getFirewallContract(address, config.signer);
+    }
+    // -- Agent Management --
+    async registerAgent(agentId, options) {
+        const tx = await this.contract.registerAgentSimple(agentId, options.ensNode, options.agentAddress, parseEther(options.spendLimit));
+        await tx.wait();
+        if (options.allowedTargets && options.allowedTargets.length > 0) {
+            const targetTx = await this.contract.setAllowedTargets(agentId, options.allowedTargets, true);
+            await targetTx.wait();
+        }
+    }
+    async getAgent(agentId) {
+        const raw = await this.contract.getAgent(agentId);
+        return {
+            ensNode: raw.ensNode,
+            agentAddress: raw.agentAddress,
+            spendLimit: raw.spendLimit,
+            threatScore: raw.threatScore,
+            strikes: raw.strikes,
+            active: raw.active,
+            worldIdVerified: raw.worldIdVerified,
+            registeredAt: raw.registeredAt,
+        };
+    }
+    async getAgentCount() {
+        return this.contract.getAgentCount();
+    }
+    async deactivateAgent(agentId) {
+        const tx = await this.contract.deactivateAgent(agentId);
+        await tx.wait();
+    }
+    async reactivateAgent(agentId) {
+        const tx = await this.contract.reactivateAgent(agentId);
+        await tx.wait();
+    }
+    // -- Target Permissions --
+    async setAllowedTarget(agentId, target, allowed) {
+        const tx = await this.contract.setAllowedTarget(agentId, target, allowed);
+        await tx.wait();
+    }
+    async isTargetAllowed(agentId, target) {
+        return this.contract.isTargetAllowed(agentId, target);
+    }
+    // -- Action Submission --
+    async submitAction(agentId, target, value, data, instruction) {
+        const tx = await this.contract.submitAction(agentId, target, parseEther(value), data, instruction);
+        const receipt = await tx.wait();
+        const iface = this.contract.interface;
+        for (const log of receipt.logs) {
+            try {
+                const parsed = iface.parseLog(log);
+                if (parsed?.name === "ActionApproved") {
+                    return { actionId: parsed.args[0], status: ActionStatus.APPROVED };
+                }
+                if (parsed?.name === "ActionEscalated") {
+                    return { actionId: parsed.args[0], status: ActionStatus.ESCALATED };
+                }
+                if (parsed?.name === "ActionBlocked") {
+                    return { actionId: parsed.args[0], status: ActionStatus.BLOCKED };
+                }
+            }
+            catch {
+                // Skip logs from other contracts
+            }
+        }
+        throw new Error("Could not determine action result from transaction logs");
+    }
+    // -- Ledger Approval --
+    async approveAction(actionId) {
+        const tx = await this.contract.approveAction(actionId);
+        await tx.wait();
+    }
+    async rejectAction(actionId) {
+        const tx = await this.contract.rejectAction(actionId);
+        await tx.wait();
+    }
+    async getQueuedAction(actionId) {
+        const raw = await this.contract.getQueuedAction(actionId);
+        return {
+            agentId: raw.agentId,
+            target: raw.target,
+            value: raw.value,
+            data: raw.data,
+            instruction: raw.instruction,
+            threatScore: raw.threatScore,
+            queuedAt: raw.queuedAt,
+            resolved: raw.resolved,
+        };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/contract.d.ts

@@ -0,0 +1,9 @@
+import { Contract, type Signer, type Provider } from "ethers";
+/**
+ * Human-readable ABI for AgentFirewall.
+ * Only includes functions currently deployed on-chain.
+ * Updated as new features are added to the contract.
+ */
+export declare const AGENT_FIREWALL_ABI: readonly ["function registerAgentSimple(string agentId, bytes32 ensNode, address agentAddress, uint256 spendLimit) external", "function getAgent(string agentId) external view returns (tuple(bytes32 ensNode, address agentAddress, uint256 spendLimit, uint256 threatScore, uint256 strikes, bool active, bool worldIdVerified, uint256 registeredAt))", "function getAgentCount() external view returns (uint256)", "function deactivateAgent(string agentId) external", "function reactivateAgent(string agentId) external", "function setAllowedTarget(string agentId, address target, bool allowed) external", "function setAllowedTargets(string agentId, address[] targets, bool allowed) external", "function isTargetAllowed(string agentId, address target) external view returns (bool)", "function submitAction(string agentId, address target, uint256 value, bytes data, string instruction) external returns (uint256 actionId, uint8 status)", "function getQueuedAction(uint256 actionId) external view returns (tuple(string agentId, address target, uint256 value, bytes data, string instruction, uint256 threatScore, uint256 queuedAt, bool resolved))", "function approveAction(uint256 actionId) external", "function rejectAction(uint256 actionId) external", "function updateThreatScore(string agentId, uint256 rawScore) external", "function setMaxStrikes(uint256 _max) external", "event AgentRegistered(string indexed agentId, bytes32 ensNode, address agentAddress, uint256 spendLimit, bool worldIdVerified)", "event AgentDeactivated(string indexed agentId, string reason)", "event AllowedTargetUpdated(string indexed agentId, address target, bool allowed)", "event ActionSubmitted(uint256 indexed actionId, string indexed agentId, address target, uint256 value, string instruction)", "event ActionApproved(uint256 indexed actionId, string indexed agentId)", "event ActionBlocked(uint256 indexed actionId, string indexed agentId, string reason)", "event ActionEscalated(uint256 indexed actionId, string indexed agentId, uint256 threatScore)", "event ThreatScoreUpdated(string indexed agentId, uint256 previousScore, uint256 newScore, uint256 rawDetectionScore, uint256 strikes)"];
+export declare function getFirewallContract(address: string, signerOrProvider: Signer | Provider): Contract;
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,qnEAsCrB,CAAC;AAEX,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,GAAG,QAAQ,GAClC,QAAQ,CAEV"}

package/dist/contract.js

@@ -0,0 +1,42 @@
+import { Contract } from "ethers";
+/**
+ * Human-readable ABI for AgentFirewall.
+ * Only includes functions currently deployed on-chain.
+ * Updated as new features are added to the contract.
+ */
+export const AGENT_FIREWALL_ABI = [
+    // Agent registration
+    "function registerAgentSimple(string agentId, bytes32 ensNode, address agentAddress, uint256 spendLimit) external",
+    "function getAgent(string agentId) external view returns (tuple(bytes32 ensNode, address agentAddress, uint256 spendLimit, uint256 threatScore, uint256 strikes, bool active, bool worldIdVerified, uint256 registeredAt))",
+    "function getAgentCount() external view returns (uint256)",
+    // Agent lifecycle
+    "function deactivateAgent(string agentId) external",
+    "function reactivateAgent(string agentId) external",
+    // Allowed targets
+    "function setAllowedTarget(string agentId, address target, bool allowed) external",
+    "function setAllowedTargets(string agentId, address[] targets, bool allowed) external",
+    "function isTargetAllowed(string agentId, address target) external view returns (bool)",
+    // Action submission
+    "function submitAction(string agentId, address target, uint256 value, bytes data, string instruction) external returns (uint256 actionId, uint8 status)",
+    "function getQueuedAction(uint256 actionId) external view returns (tuple(string agentId, address target, uint256 value, bytes data, string instruction, uint256 threatScore, uint256 queuedAt, bool resolved))",
+    // Ledger approval
+    "function approveAction(uint256 actionId) external",
+    "function rejectAction(uint256 actionId) external",
+    // Threat scores
+    "function updateThreatScore(string agentId, uint256 rawScore) external",
+    // Admin
+    "function setMaxStrikes(uint256 _max) external",
+    // Events
+    "event AgentRegistered(string indexed agentId, bytes32 ensNode, address agentAddress, uint256 spendLimit, bool worldIdVerified)",
+    "event AgentDeactivated(string indexed agentId, string reason)",
+    "event AllowedTargetUpdated(string indexed agentId, address target, bool allowed)",
+    "event ActionSubmitted(uint256 indexed actionId, string indexed agentId, address target, uint256 value, string instruction)",
+    "event ActionApproved(uint256 indexed actionId, string indexed agentId)",
+    "event ActionBlocked(uint256 indexed actionId, string indexed agentId, string reason)",
+    "event ActionEscalated(uint256 indexed actionId, string indexed agentId, uint256 threatScore)",
+    "event ThreatScoreUpdated(string indexed agentId, uint256 previousScore, uint256 newScore, uint256 rawDetectionScore, uint256 strikes)",
+];
+export function getFirewallContract(address, signerOrProvider) {
+    return new Contract(address, AGENT_FIREWALL_ABI, signerOrProvider);
+}
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA8B,MAAM,QAAQ,CAAC;AAE9D;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,qBAAqB;IACrB,kHAAkH;IAClH,2NAA2N;IAC3N,0DAA0D;IAE1D,kBAAkB;IAClB,mDAAmD;IACnD,mDAAmD;IAEnD,kBAAkB;IAClB,kFAAkF;IAClF,sFAAsF;IACtF,uFAAuF;IAEvF,oBAAoB;IACpB,wJAAwJ;IACxJ,+MAA+M;IAE/M,kBAAkB;IAClB,mDAAmD;IACnD,kDAAkD;IAElD,gBAAgB;IAChB,uEAAuE;IAEvE,QAAQ;IACR,+CAA+C;IAE/C,SAAS;IACT,gIAAgI;IAChI,+DAA+D;IAC/D,kFAAkF;IAClF,4HAA4H;IAC5H,wEAAwE;IACxE,sFAAsF;IACtF,8FAA8F;IAC9F,uIAAuI;CAC/H,CAAC;AAEX,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,gBAAmC;IAEnC,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;AACrE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { Network, NETWORK_CONFIG } from "./networks.js";
+export type { NetworkConfig } from "./networks.js";
+export { AGENT_FIREWALL_ABI, getFirewallContract } from "./contract.js";
+export { ENShell } from "./client.js";
+export { ActionStatus } from "./types.js";
+export type { Agent, RegisterAgentOptions, ActionResult, QueuedAction, ProtectOptions, ENShellConfig, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EACV,KAAK,EACL,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { Network, NETWORK_CONFIG } from "./networks.js";
+export { AGENT_FIREWALL_ABI, getFirewallContract } from "./contract.js";
+export { ENShell } from "./client.js";
+export { ActionStatus } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGxD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/networks.d.ts

@@ -0,0 +1,11 @@
+export declare enum Network {
+    MAINNET = "mainnet",
+    SEPOLIA = "sepolia"
+}
+export interface NetworkConfig {
+    chainId: number;
+    rpcUrl: string;
+    firewallAddress: string;
+}
+export declare const NETWORK_CONFIG: Record<Network, NetworkConfig>;
+//# sourceMappingURL=networks.d.ts.map

package/dist/networks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.d.ts","sourceRoot":"","sources":["../src/networks.ts"],"names":[],"mappings":"AAAA,oBAAY,OAAO;IACjB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,aAAa,CAWzD,CAAC"}

package/dist/networks.js

@@ -0,0 +1,18 @@
+export var Network;
+(function (Network) {
+    Network["MAINNET"] = "mainnet";
+    Network["SEPOLIA"] = "sepolia";
+})(Network || (Network = {}));
+export const NETWORK_CONFIG = {
+    [Network.MAINNET]: {
+        chainId: 1,
+        rpcUrl: "https://eth.llamarpc.com",
+        firewallAddress: "",
+    },
+    [Network.SEPOLIA]: {
+        chainId: 11155111,
+        rpcUrl: "https://rpc.sepolia.org",
+        firewallAddress: "",
+    },
+};
+//# sourceMappingURL=networks.js.map

package/dist/networks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.js","sourceRoot":"","sources":["../src/networks.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,OAGX;AAHD,WAAY,OAAO;IACjB,8BAAmB,CAAA;IACnB,8BAAmB,CAAA;AACrB,CAAC,EAHW,OAAO,KAAP,OAAO,QAGlB;AAQD,MAAM,CAAC,MAAM,cAAc,GAAmC;IAC5D,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QACjB,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,0BAA0B;QAClC,eAAe,EAAE,EAAE;KACpB;IACD,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QACjB,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,yBAAyB;QACjC,eAAe,EAAE,EAAE;KACpB;CACF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+import type { Signer } from "ethers";
+import type { Network } from "./networks.js";
+export interface Agent {
+    ensNode: string;
+    agentAddress: string;
+    spendLimit: bigint;
+    threatScore: bigint;
+    strikes: bigint;
+    active: boolean;
+    worldIdVerified: boolean;
+    registeredAt: bigint;
+}
+export interface RegisterAgentOptions {
+    agentAddress: string;
+    spendLimit: string;
+    ensNode: string;
+    allowedTargets?: string[];
+}
+export declare enum ActionStatus {
+    APPROVED = 0,
+    ESCALATED = 1,
+    BLOCKED = 2
+}
+export interface ActionResult {
+    actionId: bigint;
+    status: ActionStatus;
+}
+export interface QueuedAction {
+    agentId: string;
+    target: string;
+    value: bigint;
+    data: string;
+    instruction: string;
+    threatScore: bigint;
+    queuedAt: bigint;
+    resolved: boolean;
+}
+export interface ProtectOptions {
+    tx: {
+        to: string;
+        value?: string;
+        data?: string;
+    };
+    prompt: string;
+}
+export interface ENShellConfig {
+    network: Network;
+    signer: Signer;
+    contractAddress?: string;
+    onApproved?: (action: ActionResult) => Promise<void>;
+    onEscalated?: (action: ActionResult) => Promise<void>;
+    onBlocked?: (action: ActionResult) => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAID,oBAAY,YAAY;IACtB,QAAQ,IAAI;IACZ,SAAS,IAAI;IACb,OAAO,IAAI;CACZ;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE;QACF,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD"}

package/dist/types.js

@@ -0,0 +1,8 @@
+// -- Actions --
+export var ActionStatus;
+(function (ActionStatus) {
+    ActionStatus[ActionStatus["APPROVED"] = 0] = "APPROVED";
+    ActionStatus[ActionStatus["ESCALATED"] = 1] = "ESCALATED";
+    ActionStatus[ActionStatus["BLOCKED"] = 2] = "BLOCKED";
+})(ActionStatus || (ActionStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAuBA,gBAAgB;AAEhB,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,uDAAY,CAAA;IACZ,yDAAa,CAAA;IACb,qDAAW,CAAA;AACb,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@enshell/sdk",
+  "version": "0.1.0-beta.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "ethers": "^6.15.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.18.11",
+    "@vitest/coverage-v8": "^4.1.2",
+    "typescript": "~5.8.0",
+    "vitest": "^4.1.2"
+  }
+}