@agenticocean/vault 0.1.0

package/dist/agent-registry.d.ts

@@ -0,0 +1,18 @@
+import type { StellarClientConfig, AgentInfo, LoggerLike } from "./types.js";
+/**
+ * Read-only client for the AgentRegistry contract.
+ */
+export declare class AgentRegistry {
+    private reader;
+    private registryAddress;
+    constructor(registryAddress: string, config: StellarClientConfig, logger?: LoggerLike);
+    /** List active agents starting from startId, up to limit. */
+    listAgents(startId?: number, limit?: number): Promise<AgentInfo[]>;
+    /** Get a specific agent by ID. */
+    getAgent(agentId: number): Promise<AgentInfo | null>;
+    /** Get the agent ID registered by a given owner address. */
+    getAgentByOwner(owner: string): Promise<number | null>;
+    /** Get the total number of active agents. */
+    getAgentCount(): Promise<number>;
+}
+//# sourceMappingURL=agent-registry.d.ts.map

package/dist/agent-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.d.ts","sourceRoot":"","sources":["../src/agent-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7E;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,eAAe,CAAS;gBAEpB,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,UAAU;IAKrF,6DAA6D;IACvD,UAAU,CAAC,OAAO,GAAE,MAAU,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAS/E,kCAAkC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAQ1D,4DAA4D;IACtD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQ5D,6CAA6C;IACvC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;CAIvC"}

package/dist/agent-registry.js

@@ -0,0 +1,32 @@
+import { nativeToScVal } from "@stellar/stellar-sdk";
+import { ContractReader } from "./contract-reader.js";
+/**
+ * Read-only client for the AgentRegistry contract.
+ */
+export class AgentRegistry {
+    reader;
+    registryAddress;
+    constructor(registryAddress, config, logger) {
+        this.registryAddress = registryAddress;
+        this.reader = new ContractReader(config, logger);
+    }
+    /** List active agents starting from startId, up to limit. */
+    async listAgents(startId = 1, limit = 10) {
+        const result = await this.reader.readContractValue(this.registryAddress, "list_agents", [nativeToScVal(startId, { type: "u32" }), nativeToScVal(limit, { type: "u32" })]);
+        return result || [];
+    }
+    /** Get a specific agent by ID. */
+    async getAgent(agentId) {
+        return await this.reader.readContractValue(this.registryAddress, "get_agent", [nativeToScVal(agentId, { type: "u32" })]);
+    }
+    /** Get the agent ID registered by a given owner address. */
+    async getAgentByOwner(owner) {
+        return await this.reader.readContractValue(this.registryAddress, "get_agent_by_owner", [nativeToScVal(owner, { type: "address" })]);
+    }
+    /** Get the total number of active agents. */
+    async getAgentCount() {
+        const count = await this.reader.readContractValue(this.registryAddress, "agent_count");
+        return count || 0;
+    }
+}
+//# sourceMappingURL=agent-registry.js.map

package/dist/agent-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.js","sourceRoot":"","sources":["../src/agent-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAiB;IACvB,eAAe,CAAS;IAEhC,YAAY,eAAuB,EAAE,MAA2B,EAAE,MAAmB;QACnF,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,UAAU,CAAC,UAAkB,CAAC,EAAE,QAAgB,EAAE;QACtD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAChD,IAAI,CAAC,eAAe,EACpB,aAAa,EACb,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,aAAa,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CACjF,CAAC;QACF,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CACxC,IAAI,CAAC,eAAe,EACpB,WAAW,EACX,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAC1C,CAAC;IACJ,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,eAAe,CAAC,KAAa;QACjC,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CACxC,IAAI,CAAC,eAAe,EACpB,oBAAoB,EACpB,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAC5C,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,aAAa;QACjB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;QACvF,OAAO,KAAK,IAAI,CAAC,CAAC;IACpB,CAAC;CACF"}

package/dist/contract-reader.d.ts

@@ -0,0 +1,20 @@
+import type { StellarClientConfig, LoggerLike } from "./types.js";
+/**
+ * Low-level contract reader that simulates read-only contract calls.
+ */
+export declare class ContractReader {
+    private rpc;
+    private simulationSource;
+    private passphrase;
+    private log;
+    constructor(config: StellarClientConfig, logger?: LoggerLike);
+    /**
+     * Simulate a read-only contract call and return the decoded result.
+     */
+    readContractValue(contractId: string, method: string, args?: any[]): Promise<any>;
+    /**
+     * Recursively convert BigInt values to numbers for JSON serialization.
+     */
+    private convertBigInts;
+}
+//# sourceMappingURL=contract-reader.d.ts.map

package/dist/contract-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-reader.d.ts","sourceRoot":"","sources":["../src/contract-reader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIlE;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,GAAG,CAAa;gBAEZ,MAAM,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,UAAU;IAO5D;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAwB3F;;OAEG;IACH,OAAO,CAAC,cAAc;CAavB"}

package/dist/contract-reader.js

@@ -0,0 +1,64 @@
+import { Contract, scValToNative, TransactionBuilder } from "@stellar/stellar-sdk";
+import { Server } from "@stellar/stellar-sdk/rpc";
+const DEFAULT_SOURCE = "GAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWHF";
+/**
+ * Low-level contract reader that simulates read-only contract calls.
+ */
+export class ContractReader {
+    rpc;
+    simulationSource;
+    passphrase;
+    log;
+    constructor(config, logger) {
+        this.rpc = new Server(config.rpcUrl);
+        this.passphrase = config.networkPassphrase;
+        this.simulationSource = config.simulationSourceKey || DEFAULT_SOURCE;
+        this.log = logger ?? console;
+    }
+    /**
+     * Simulate a read-only contract call and return the decoded result.
+     */
+    async readContractValue(contractId, method, args = []) {
+        try {
+            const contract = new Contract(contractId);
+            const account = await this.rpc.getAccount(this.simulationSource);
+            const tx = new TransactionBuilder(account, {
+                fee: "100",
+                networkPassphrase: this.passphrase,
+            })
+                .addOperation(contract.call(method, ...args))
+                .setTimeout(30)
+                .build();
+            const result = await this.rpc.simulateTransaction(tx);
+            if ("result" in result && result.result?.retval) {
+                const native = scValToNative(result.result.retval);
+                return this.convertBigInts(native);
+            }
+            return null;
+        }
+        catch (err) {
+            this.log.error("Contract read failed", { contractId, method, error: err });
+            return null;
+        }
+    }
+    /**
+     * Recursively convert BigInt values to numbers for JSON serialization.
+     */
+    convertBigInts(obj) {
+        if (obj === null || obj === undefined)
+            return obj;
+        if (typeof obj === "bigint")
+            return Number(obj);
+        if (Array.isArray(obj))
+            return obj.map((item) => this.convertBigInts(item));
+        if (typeof obj === "object") {
+            const converted = {};
+            for (const key in obj) {
+                converted[key] = this.convertBigInts(obj[key]);
+            }
+            return converted;
+        }
+        return obj;
+    }
+}
+//# sourceMappingURL=contract-reader.js.map

package/dist/contract-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-reader.js","sourceRoot":"","sources":["../src/contract-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAGlD,MAAM,cAAc,GAAG,0DAA0D,CAAC;AAElF;;GAEG;AACH,MAAM,OAAO,cAAc;IACjB,GAAG,CAAS;IACZ,gBAAgB,CAAS;IACzB,UAAU,CAAS;IACnB,GAAG,CAAa;IAExB,YAAY,MAA2B,EAAE,MAAmB;QAC1D,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,iBAAiB,CAAC;QAC3C,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,mBAAmB,IAAI,cAAc,CAAC;QACrE,IAAI,CAAC,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,UAAkB,EAAE,MAAc,EAAE,OAAc,EAAE;QAC1E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACjE,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,OAAO,EAAE;gBACzC,GAAG,EAAE,KAAK;gBACV,iBAAiB,EAAE,IAAI,CAAC,UAAU;aACnC,CAAC;iBACC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;iBAC5C,UAAU,CAAC,EAAE,CAAC;iBACd,KAAK,EAAE,CAAC;YAEX,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;YACtD,IAAI,QAAQ,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;gBAChD,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACnD,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YACrC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAC3E,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,GAAQ;QAC7B,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC;QAClD,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5E,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAQ,EAAE,CAAC;YAC1B,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;gBACtB,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export type { StellarClientConfig, AgentPolicy, AgentInfo, FeedbackSummary, Feedback, Validation, LoggerLike, } from "./types.js";
+export { ContractReader } from "./contract-reader.js";
+export { VaultFactory } from "./vault-factory.js";
+export { UserVault } from "./user-vault.js";
+export { AgentRegistry } from "./agent-registry.js";
+export { ReputationRegistry } from "./reputation-registry.js";
+export { ValidationRegistry } from "./validation-registry.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":"AACA,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,SAAS,EACT,eAAe,EACf,QAAQ,EACR,UAAU,EACV,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// ── Contract Reader ──
+export { ContractReader } from "./contract-reader.js";
+// ── Vault Factory ──
+export { VaultFactory } from "./vault-factory.js";
+// ── User Vault ──
+export { UserVault } from "./user-vault.js";
+// ── Agent Registry ──
+export { AgentRegistry } from "./agent-registry.js";
+// ── Reputation Registry ──
+export { ReputationRegistry } from "./reputation-registry.js";
+// ── Validation Registry ──
+export { ValidationRegistry } from "./validation-registry.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":"AAWA,wBAAwB;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,sBAAsB;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,mBAAmB;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,uBAAuB;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,4BAA4B;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,4BAA4B;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/reputation-registry.d.ts

@@ -0,0 +1,14 @@
+import type { StellarClientConfig, FeedbackSummary, Feedback, LoggerLike } from "./types.js";
+/**
+ * Read-only client for the ReputationRegistry contract.
+ */
+export declare class ReputationRegistry {
+    private reader;
+    private reputationAddress;
+    constructor(reputationAddress: string, config: StellarClientConfig, logger?: LoggerLike);
+    /** Get the feedback summary for an agent. */
+    getSummary(agentId: number): Promise<FeedbackSummary>;
+    /** Get paginated feedback entries for an agent. */
+    getFeedback(agentId: number, offset?: number, limit?: number): Promise<Feedback[]>;
+}
+//# sourceMappingURL=reputation-registry.d.ts.map

package/dist/reputation-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reputation-registry.d.ts","sourceRoot":"","sources":["../src/reputation-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7F;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,UAAU;IAKvF,6CAA6C;IACvC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAS3D,mDAAmD;IAC7C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAYhG"}

package/dist/reputation-registry.js

@@ -0,0 +1,28 @@
+import { nativeToScVal } from "@stellar/stellar-sdk";
+import { ContractReader } from "./contract-reader.js";
+/**
+ * Read-only client for the ReputationRegistry contract.
+ */
+export class ReputationRegistry {
+    reader;
+    reputationAddress;
+    constructor(reputationAddress, config, logger) {
+        this.reputationAddress = reputationAddress;
+        this.reader = new ContractReader(config, logger);
+    }
+    /** Get the feedback summary for an agent. */
+    async getSummary(agentId) {
+        const result = await this.reader.readContractValue(this.reputationAddress, "get_feedback_summary", [nativeToScVal(agentId, { type: "u32" })]);
+        return result || { total_reviews: 0, avg_score_x100: 0, category_counts: 0, total_score: 0 };
+    }
+    /** Get paginated feedback entries for an agent. */
+    async getFeedback(agentId, offset = 0, limit = 10) {
+        const result = await this.reader.readContractValue(this.reputationAddress, "get_feedback", [
+            nativeToScVal(agentId, { type: "u32" }),
+            nativeToScVal(offset, { type: "u32" }),
+            nativeToScVal(limit, { type: "u32" }),
+        ]);
+        return result || [];
+    }
+}
+//# sourceMappingURL=reputation-registry.js.map

package/dist/reputation-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reputation-registry.js","sourceRoot":"","sources":["../src/reputation-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAAiB;IACvB,iBAAiB,CAAS;IAElC,YAAY,iBAAyB,EAAE,MAA2B,EAAE,MAAmB;QACrF,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,UAAU,CAAC,OAAe;QAC9B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAChD,IAAI,CAAC,iBAAiB,EACtB,sBAAsB,EACtB,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAC1C,CAAC;QACF,OAAO,MAAM,IAAI,EAAE,aAAa,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;IAC/F,CAAC;IAED,mDAAmD;IACnD,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,SAAiB,CAAC,EAAE,QAAgB,EAAE;QACvE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAChD,IAAI,CAAC,iBAAiB,EACtB,cAAc,EACd;YACE,aAAa,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YACvC,aAAa,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YACtC,aAAa,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;SACtC,CACF,CAAC;QACF,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+export interface StellarClientConfig {
+    rpcUrl: string;
+    networkPassphrase: string;
+    /** Public key of a funded account used as source for read-only simulations. */
+    simulationSourceKey?: string;
+}
+export interface AgentPolicy {
+    agent_address: string;
+    daily_limit: string;
+    spent_today: string;
+    last_reset: number;
+    allowed_destinations: string[];
+    is_active: boolean;
+}
+export interface AgentInfo {
+    id: number;
+    owner: string;
+    name: string;
+    agent_uri: string;
+    vault_address: string;
+    agent_signer: string;
+    registered_at: number;
+    is_active: boolean;
+}
+export interface FeedbackSummary {
+    total_reviews: number;
+    total_score: number;
+    avg_score_x100: number;
+}
+export interface Feedback {
+    agent_id: number;
+    reviewer: string;
+    score: number;
+    category: string;
+    data_uri: string;
+    payment_proof_hash: string;
+    timestamp: number;
+}
+export interface Validation {
+    request_id: number;
+    agent_id: number;
+    validator: string;
+    request_uri: string;
+    data_hash: string;
+    status: "Pending" | "Completed" | "Failed";
+    success: boolean;
+    evidence_uri: string;
+    requested_at: number;
+    completed_at: number;
+}
+export interface LoggerLike {
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): 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":"AAEA,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAID,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;CACpB;AAID,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB;AAID,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC9C"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// ── Stellar Client Config ──
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8BAA8B"}

package/dist/user-vault.d.ts

@@ -0,0 +1,18 @@
+import type { StellarClientConfig, AgentPolicy, LoggerLike } from "./types.js";
+/**
+ * Read-only client for a UserVault contract instance.
+ */
+export declare class UserVault {
+    private reader;
+    private vaultAddress;
+    constructor(vaultAddress: string, config: StellarClientConfig, logger?: LoggerLike);
+    /** Get the USDC balance of this vault (in stroops). */
+    getBalance(): Promise<string>;
+    /** Get the lifetime total USDC spent through agent_pay (in stroops). */
+    getTotalSpent(): Promise<string>;
+    /** Get the spending policy for a specific agent. */
+    getAgentPolicy(agentAddress: string): Promise<AgentPolicy | null>;
+    /** Get the remaining daily spending limit for an agent (in stroops). */
+    getRemainingLimit(agentAddress: string): Promise<string>;
+}
+//# sourceMappingURL=user-vault.d.ts.map

package/dist/user-vault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-vault.d.ts","sourceRoot":"","sources":["../src/user-vault.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/E;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,UAAU;IAKlF,uDAAuD;IACjD,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAKnC,wEAAwE;IAClE,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAKtC,oDAAoD;IAC9C,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAQvE,wEAAwE;IAClE,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAQ/D"}

package/dist/user-vault.js

@@ -0,0 +1,33 @@
+import { nativeToScVal } from "@stellar/stellar-sdk";
+import { ContractReader } from "./contract-reader.js";
+/**
+ * Read-only client for a UserVault contract instance.
+ */
+export class UserVault {
+    reader;
+    vaultAddress;
+    constructor(vaultAddress, config, logger) {
+        this.vaultAddress = vaultAddress;
+        this.reader = new ContractReader(config, logger);
+    }
+    /** Get the USDC balance of this vault (in stroops). */
+    async getBalance() {
+        const balance = await this.reader.readContractValue(this.vaultAddress, "balance");
+        return balance?.toString() || "0";
+    }
+    /** Get the lifetime total USDC spent through agent_pay (in stroops). */
+    async getTotalSpent() {
+        const total = await this.reader.readContractValue(this.vaultAddress, "total_spent");
+        return total?.toString() || "0";
+    }
+    /** Get the spending policy for a specific agent. */
+    async getAgentPolicy(agentAddress) {
+        return await this.reader.readContractValue(this.vaultAddress, "get_agent_policy", [nativeToScVal(agentAddress, { type: "address" })]);
+    }
+    /** Get the remaining daily spending limit for an agent (in stroops). */
+    async getRemainingLimit(agentAddress) {
+        const result = await this.reader.readContractValue(this.vaultAddress, "remaining_limit", [nativeToScVal(agentAddress, { type: "address" })]);
+        return result?.toString() || "0";
+    }
+}
+//# sourceMappingURL=user-vault.js.map

package/dist/user-vault.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-vault.js","sourceRoot":"","sources":["../src/user-vault.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD;;GAEG;AACH,MAAM,OAAO,SAAS;IACZ,MAAM,CAAiB;IACvB,YAAY,CAAS;IAE7B,YAAY,YAAoB,EAAE,MAA2B,EAAE,MAAmB;QAChF,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,UAAU;QACd,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QAClF,OAAO,OAAO,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC;IACpC,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,aAAa;QACjB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;QACpF,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC;IAClC,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,cAAc,CAAC,YAAoB;QACvC,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CACxC,IAAI,CAAC,YAAY,EACjB,kBAAkB,EAClB,CAAC,aAAa,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CACnD,CAAC;IACJ,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,iBAAiB,CAAC,YAAoB;QAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAChD,IAAI,CAAC,YAAY,EACjB,iBAAiB,EACjB,CAAC,aAAa,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CACnD,CAAC;QACF,OAAO,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC;IACnC,CAAC;CACF"}

package/dist/validation-registry.d.ts

@@ -0,0 +1,12 @@
+import type { StellarClientConfig, Validation, LoggerLike } from "./types.js";
+/**
+ * Read-only client for the ValidationRegistry contract.
+ */
+export declare class ValidationRegistry {
+    private reader;
+    private validationAddress;
+    constructor(validationAddress: string, config: StellarClientConfig, logger?: LoggerLike);
+    /** Get all validations for an agent. */
+    getValidations(agentId: number): Promise<Validation[]>;
+}
+//# sourceMappingURL=validation-registry.d.ts.map

package/dist/validation-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-registry.d.ts","sourceRoot":"","sources":["../src/validation-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE9E;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,UAAU;IAKvF,wCAAwC;IAClC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAQ7D"}

package/dist/validation-registry.js

@@ -0,0 +1,19 @@
+import { nativeToScVal } from "@stellar/stellar-sdk";
+import { ContractReader } from "./contract-reader.js";
+/**
+ * Read-only client for the ValidationRegistry contract.
+ */
+export class ValidationRegistry {
+    reader;
+    validationAddress;
+    constructor(validationAddress, config, logger) {
+        this.validationAddress = validationAddress;
+        this.reader = new ContractReader(config, logger);
+    }
+    /** Get all validations for an agent. */
+    async getValidations(agentId) {
+        const result = await this.reader.readContractValue(this.validationAddress, "get_validations", [nativeToScVal(agentId, { type: "u32" })]);
+        return result || [];
+    }
+}
+//# sourceMappingURL=validation-registry.js.map

package/dist/validation-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-registry.js","sourceRoot":"","sources":["../src/validation-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAAiB;IACvB,iBAAiB,CAAS;IAElC,YAAY,iBAAyB,EAAE,MAA2B,EAAE,MAAmB;QACrF,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAChD,IAAI,CAAC,iBAAiB,EACtB,iBAAiB,EACjB,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAC1C,CAAC;QACF,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;CACF"}

package/dist/vault-factory.d.ts

@@ -0,0 +1,16 @@
+import type { StellarClientConfig, LoggerLike } from "./types.js";
+/**
+ * Read-only client for the VaultFactory contract.
+ */
+export declare class VaultFactory {
+    private reader;
+    private factoryAddress;
+    constructor(factoryAddress: string, config: StellarClientConfig, logger?: LoggerLike);
+    /** Get the vault address for a given owner, or null if none exists. */
+    getVault(owner: string): Promise<string | null>;
+    /** Check whether an owner has a vault. */
+    hasVault(owner: string): Promise<boolean>;
+    /** Get the total number of vaults created. */
+    vaultCount(): Promise<number>;
+}
+//# sourceMappingURL=vault-factory.d.ts.map

package/dist/vault-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-factory.d.ts","sourceRoot":"","sources":["../src/vault-factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAElE;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,cAAc,CAAS;gBAEnB,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,UAAU;IAKpF,uEAAuE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQrD,0CAA0C;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/C,8CAA8C;IACxC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CAIpC"}

package/dist/vault-factory.js

@@ -0,0 +1,28 @@
+import { nativeToScVal } from "@stellar/stellar-sdk";
+import { ContractReader } from "./contract-reader.js";
+/**
+ * Read-only client for the VaultFactory contract.
+ */
+export class VaultFactory {
+    reader;
+    factoryAddress;
+    constructor(factoryAddress, config, logger) {
+        this.factoryAddress = factoryAddress;
+        this.reader = new ContractReader(config, logger);
+    }
+    /** Get the vault address for a given owner, or null if none exists. */
+    async getVault(owner) {
+        return await this.reader.readContractValue(this.factoryAddress, "get_vault", [nativeToScVal(owner, { type: "address" })]);
+    }
+    /** Check whether an owner has a vault. */
+    async hasVault(owner) {
+        const vault = await this.getVault(owner);
+        return vault !== null;
+    }
+    /** Get the total number of vaults created. */
+    async vaultCount() {
+        const count = await this.reader.readContractValue(this.factoryAddress, "vault_count");
+        return count || 0;
+    }
+}
+//# sourceMappingURL=vault-factory.js.map

package/dist/vault-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-factory.js","sourceRoot":"","sources":["../src/vault-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,MAAM,CAAiB;IACvB,cAAc,CAAS;IAE/B,YAAY,cAAsB,EAAE,MAA2B,EAAE,MAAmB;QAClF,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,QAAQ,CAAC,KAAa;QAC1B,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CACxC,IAAI,CAAC,cAAc,EACnB,WAAW,EACX,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAC5C,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,QAAQ,CAAC,KAAa;QAC1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,KAAK,KAAK,IAAI,CAAC;IACxB,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,UAAU;QACd,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;QACtF,OAAO,KAAK,IAAI,CAAC,CAAC;IACpB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@agenticocean/vault",
+  "version": "0.1.0",
+  "description": "Smart vault and agent identity SDK for Stellar/Soroban",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@stellar/stellar-sdk": "^13.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT"
+}