tenzro-sdk 0.1.0

package/dist/agent.js

@@ -0,0 +1,300 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentClient = void 0;
+// Simple UUID v4 generator for browser/node compatibility
+function generateUUID() {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = Math.random() * 16 | 0;
+        const v = c === 'x' ? r : (r & 0x3 | 0x8);
+        return v.toString(16);
+    });
+}
+/**
+ * Client for AI agent operations.
+ * Supports agent registration, messaging, and task delegation.
+ */
+class AgentClient {
+    rpc;
+    constructor(rpc) {
+        this.rpc = rpc;
+    }
+    /**
+     * Register a new AI agent on the network.
+     * @param agentId - Unique identifier for the agent
+     * @param name - Human-readable name
+     * @param capabilities - List of agent capabilities
+     * @returns Registration response with agent ID and status
+     */
+    async register(agentId, name, capabilities) {
+        return this.rpc.call("tenzro_registerAgent", [
+            {
+                agent_id: agentId,
+                name,
+                capabilities,
+            },
+        ]);
+    }
+    /**
+     * Send a message to another agent.
+     * @param agentId - Target agent identifier
+     * @param message - Message content
+     * @returns Message response with payload and message ID
+     */
+    async sendMessage(agentId, message) {
+        return this.rpc.call("tenzro_sendAgentMessage", [
+            {
+                agent_id: agentId,
+                message,
+            },
+        ]);
+    }
+    /**
+     * Delegate a task to an agent using the A2A protocol.
+     * @param agentId - Target agent identifier
+     * @param taskDescription - Description of the task to delegate
+     * @returns Task delegation response with ID and status
+     */
+    async delegateTask(agentId, taskDescription) {
+        return this.rpc.post("/a2a", {
+            jsonrpc: "2.0",
+            method: "tasks/send",
+            params: {
+                id: generateUUID(),
+                message: {
+                    role: "user",
+                    parts: [{ type: "text", text: taskDescription }],
+                },
+            },
+            id: 1,
+        });
+    }
+    /**
+     * List all registered agents on the network.
+     * @returns Array of agent identities
+     */
+    async listAgents() {
+        return this.rpc.call("tenzro_listAgents");
+    }
+    /**
+     * Spawn a child agent under a parent agent.
+     * @param parentId - The parent agent's ID
+     * @param name - Name for the new child agent
+     * @param capabilities - List of capability strings for the child agent
+     * @returns Spawned agent info with agent_id, parent_id, and name
+     */
+    async spawnAgent(parentId, name, capabilities) {
+        return this.rpc.call("tenzro_spawnAgent", [
+            { parent_id: parentId, name, capabilities },
+        ]);
+    }
+    /**
+     * Run an agentic task loop for an agent.
+     * The agent calls an LLM with built-in tools (spawn_agent, delegate_task,
+     * collect_results, complete) and executes them iteratively until done.
+     * @param agentId - The agent that will execute the task
+     * @param task - Task description
+     * @param inferenceUrl - Optional URL of the inference endpoint (default: localhost)
+     * @returns Final task result
+     */
+    async runAgentTask(agentId, task, inferenceUrl) {
+        return this.rpc.call("tenzro_runAgentTask", [
+            { agent_id: agentId, task, inference_url: inferenceUrl },
+        ]);
+    }
+    /**
+     * Create a swarm of member agents under an orchestrator.
+     * @param orchestratorId - The orchestrator agent's ID
+     * @param members - Array of member specs (name + capabilities)
+     * @param options - Optional swarm configuration
+     * @returns Swarm ID and orchestrator ID
+     */
+    async createSwarm(orchestratorId, members, options) {
+        return this.rpc.call("tenzro_createSwarm", [
+            { orchestrator_id: orchestratorId, members, ...options },
+        ]);
+    }
+    /**
+     * Get the current status of a swarm.
+     * @param swarmId - The swarm's ID
+     * @returns Swarm status including member statuses
+     */
+    async getSwarmStatus(swarmId) {
+        return this.rpc.call("tenzro_getSwarmStatus", [
+            { swarm_id: swarmId },
+        ]);
+    }
+    /**
+     * Terminate a swarm and all its member agents.
+     * @param swarmId - The swarm's ID
+     * @returns Confirmation with swarm_id and status "terminated"
+     */
+    async terminateSwarm(swarmId) {
+        return this.rpc.call("tenzro_terminateSwarm", [
+            { swarm_id: swarmId },
+        ]);
+    }
+    // ─── AgentKit: Template-based agent lifecycle ─────────────────────────────
+    /**
+     * Spawn a new agent from a registered template.
+     * @param templateId - The template to instantiate
+     * @param displayName - Optional human-readable name for the spawned agent
+     * @param context - Optional key-value context passed to the agent at boot
+     * @returns Spawned agent info with agent_id, template_id, name, and status
+     */
+    async spawnAgentTemplate(templateId, displayName, context) {
+        return this.rpc.call("tenzro_spawnAgentTemplate", [
+            { template_id: templateId, display_name: displayName, context },
+        ]);
+    }
+    /**
+     * Run an already-spawned template agent through its task loop.
+     * @param agentId - The agent to run
+     * @param maxIterations - Optional cap on loop iterations (default: server-side default)
+     * @param dryRun - If true, simulate execution without side effects
+     * @returns Execution report with iterations, status, result, and duration
+     */
+    async runAgentTemplate(agentId, maxIterations, dryRun) {
+        return this.rpc.call("tenzro_runAgentTemplate", [
+            { agent_id: agentId, max_iterations: maxIterations, dry_run: dryRun },
+        ]);
+    }
+    /**
+     * Download a template's full definition for offline inspection or forking.
+     * @param templateId - The template to download
+     * @returns Full agent template
+     */
+    async downloadAgentTemplate(templateId) {
+        return this.rpc.call("tenzro_downloadAgentTemplate", [
+            { template_id: templateId },
+        ]);
+    }
+    /**
+     * Update a registered agent template (must be the creator).
+     * @param templateId - The template to update
+     * @param params - Fields to update (partial — only provided fields are changed)
+     * @returns Updated agent template
+     */
+    async updateAgentTemplate(templateId, params) {
+        return this.rpc.call("tenzro_updateAgentTemplate", [
+            { template_id: templateId, ...params },
+        ]);
+    }
+    // ─── Discovery & Lifecycle ──────────────────────────────────────────────────
+    /**
+     * Discover available models with optional filters.
+     * @param options - Optional filters: modality, servingOnly, query
+     * @returns Array of discovered models
+     */
+    async discoverModels(options) {
+        return this.rpc.call("tenzro_discoverModels", [
+            {
+                modality: options?.modality,
+                serving_only: options?.servingOnly,
+                query: options?.query,
+            },
+        ]);
+    }
+    /**
+     * Discover available agents with optional capability filter.
+     * @param capability - Optional capability to filter by
+     * @returns Array of discovered agents
+     */
+    async discoverAgents(capability) {
+        return this.rpc.call("tenzro_discoverAgents", [{ capability }]);
+    }
+    /**
+     * Spawn an agent with a specific skill attached.
+     * @param parentId - The parent agent's ID
+     * @param name - Name for the new agent
+     * @param skillId - Skill to attach to the agent
+     * @param capabilities - Optional list of capabilities
+     * @returns Spawned agent info
+     */
+    async spawnAgentWithSkill(parentId, name, skillId, capabilities) {
+        return this.rpc.call("tenzro_spawnAgentWithSkill", [
+            {
+                parent_id: parentId,
+                name,
+                skill_id: skillId,
+                capabilities,
+            },
+        ]);
+    }
+    /**
+     * Fund an agent's wallet.
+     * @param agentId - The agent to fund
+     * @param fromAddress - Source address for the funds
+     * @param amountTnzo - Amount of TNZO to transfer
+     * @returns Funding result
+     */
+    async fundAgent(agentId, fromAddress, amountTnzo) {
+        return this.rpc.call("tenzro_fundAgent", [
+            {
+                agent_id: agentId,
+                from_address: fromAddress,
+                amount_tnzo: amountTnzo,
+            },
+        ]);
+    }
+    /**
+     * Swap tokens for an agent.
+     * @param agentId - The agent performing the swap
+     * @param fromToken - Source token identifier
+     * @param toToken - Destination token identifier
+     * @param amount - Amount to swap
+     * @param chain - Optional chain for the swap
+     * @returns Swap result
+     */
+    async swapToken(agentId, fromToken, toToken, amount, chain) {
+        return this.rpc.call("tenzro_swapToken", [
+            {
+                agent_id: agentId,
+                from_token: fromToken,
+                to_token: toToken,
+                amount,
+                chain,
+            },
+        ]);
+    }
+    /**
+     * Run the full agent payment pipeline for inference.
+     * @param agentId - The agent paying for inference
+     * @param modelId - The model to use
+     * @param prompt - The prompt to send
+     * @param maxTokens - Optional max tokens for the response
+     * @returns Inference result with payment details
+     */
+    async agentPayForInference(agentId, modelId, prompt, maxTokens) {
+        return this.rpc.call("tenzro_agentPayForInference", [
+            {
+                agent_id: agentId,
+                model_id: modelId,
+                prompt,
+                max_tokens: maxTokens,
+            },
+        ]);
+    }
+    /**
+     * Set the gas policy for an agent's on-chain operations.
+     * @param agentId - The agent identifier
+     * @param policy - Gas policy configuration
+     * @returns Updated gas policy
+     */
+    async setGasPolicy(agentId, policy) {
+        return this.rpc.call("tenzro_setAgentGasPolicy", [
+            { agent_id: agentId, ...policy },
+        ]);
+    }
+    /**
+     * Get the current gas policy for an agent.
+     * @param agentId - The agent identifier
+     * @returns Current gas policy
+     */
+    async getGasPolicy(agentId) {
+        return this.rpc.call("tenzro_getAgentGasPolicy", [
+            { agent_id: agentId },
+        ]);
+    }
+}
+exports.AgentClient = AgentClient;
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/ap2.d.ts

@@ -0,0 +1,54 @@
+import type { RpcClient } from './rpc';
+import type { Ap2Session, Ap2Authorization, PaymentReceipt, CancelResult } from './types';
+/**
+ * Client for the AP2 (Agentic Payment Protocol).
+ * Enables agents to establish payment sessions with providers,
+ * authorize individual payments, and manage session lifecycle.
+ */
+export declare class Ap2Client {
+    private readonly rpc;
+    constructor(rpc: RpcClient);
+    /**
+     * Create a new AP2 payment session between an agent and a provider.
+     * @param agentDid - DID of the agent initiating the session
+     * @param providerDid - DID of the service provider
+     * @param service - Service identifier (e.g., model ID or endpoint)
+     * @param maxAmount - Maximum authorized spend for this session (decimal string)
+     * @param asset - Asset to use for payments (default: "TNZO")
+     * @returns Created AP2 session
+     */
+    createSession(agentDid: string, providerDid: string, service: string, maxAmount: string, asset?: string): Promise<Ap2Session>;
+    /**
+     * Authorize a payment within an existing AP2 session.
+     * @param sessionId - The session to authorize against
+     * @param amount - Amount to authorize (decimal string)
+     * @returns Payment authorization
+     */
+    authorizePayment(sessionId: string, amount: string): Promise<Ap2Authorization>;
+    /**
+     * Execute a previously authorized payment.
+     * @param sessionId - The session containing the authorization
+     * @param authorizationId - The authorization to execute
+     * @returns Payment receipt
+     */
+    executePayment(sessionId: string, authorizationId: string): Promise<PaymentReceipt>;
+    /**
+     * Cancel an active AP2 session.
+     * @param sessionId - The session to cancel
+     * @returns Cancellation result with optional refund info
+     */
+    cancelSession(sessionId: string): Promise<CancelResult>;
+    /**
+     * Get details of an AP2 session.
+     * @param sessionId - The session identifier
+     * @returns Session details
+     */
+    getSession(sessionId: string): Promise<Ap2Session>;
+    /**
+     * List all AP2 sessions for a given agent.
+     * @param agentDid - The agent's DID
+     * @returns Array of AP2 sessions
+     */
+    listAgentSessions(agentDid: string): Promise<Ap2Session[]>;
+}
+//# sourceMappingURL=ap2.d.ts.map

package/dist/ap2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ap2.d.ts","sourceRoot":"","sources":["../src/ap2.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAE3C;;;;;;;;OAQG;IACG,aAAa,CACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAe,GACrB,OAAO,CAAC,UAAU,CAAC;IAYtB;;;;;OAKG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC;IAM5B;;;;;OAKG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC;IAM1B;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAM7D;;;;OAIG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAMxD;;;;OAIG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAKjE"}

package/dist/ap2.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Ap2Client = void 0;
+/**
+ * Client for the AP2 (Agentic Payment Protocol).
+ * Enables agents to establish payment sessions with providers,
+ * authorize individual payments, and manage session lifecycle.
+ */
+class Ap2Client {
+    rpc;
+    constructor(rpc) {
+        this.rpc = rpc;
+    }
+    /**
+     * Create a new AP2 payment session between an agent and a provider.
+     * @param agentDid - DID of the agent initiating the session
+     * @param providerDid - DID of the service provider
+     * @param service - Service identifier (e.g., model ID or endpoint)
+     * @param maxAmount - Maximum authorized spend for this session (decimal string)
+     * @param asset - Asset to use for payments (default: "TNZO")
+     * @returns Created AP2 session
+     */
+    async createSession(agentDid, providerDid, service, maxAmount, asset = 'TNZO') {
+        return this.rpc.call('tenzro_ap2CreateSession', [
+            {
+                agent_did: agentDid,
+                provider_did: providerDid,
+                service,
+                max_amount: maxAmount,
+                asset,
+            },
+        ]);
+    }
+    /**
+     * Authorize a payment within an existing AP2 session.
+     * @param sessionId - The session to authorize against
+     * @param amount - Amount to authorize (decimal string)
+     * @returns Payment authorization
+     */
+    async authorizePayment(sessionId, amount) {
+        return this.rpc.call('tenzro_ap2AuthorizePayment', [
+            { session_id: sessionId, amount },
+        ]);
+    }
+    /**
+     * Execute a previously authorized payment.
+     * @param sessionId - The session containing the authorization
+     * @param authorizationId - The authorization to execute
+     * @returns Payment receipt
+     */
+    async executePayment(sessionId, authorizationId) {
+        return this.rpc.call('tenzro_ap2ExecutePayment', [
+            { session_id: sessionId, authorization_id: authorizationId },
+        ]);
+    }
+    /**
+     * Cancel an active AP2 session.
+     * @param sessionId - The session to cancel
+     * @returns Cancellation result with optional refund info
+     */
+    async cancelSession(sessionId) {
+        return this.rpc.call('tenzro_ap2CancelSession', [
+            { session_id: sessionId },
+        ]);
+    }
+    /**
+     * Get details of an AP2 session.
+     * @param sessionId - The session identifier
+     * @returns Session details
+     */
+    async getSession(sessionId) {
+        return this.rpc.call('tenzro_ap2GetSession', [
+            { session_id: sessionId },
+        ]);
+    }
+    /**
+     * List all AP2 sessions for a given agent.
+     * @param agentDid - The agent's DID
+     * @returns Array of AP2 sessions
+     */
+    async listAgentSessions(agentDid) {
+        return this.rpc.call('tenzro_ap2ListAgentSessions', [
+            { agent_did: agentDid },
+        ]);
+    }
+}
+exports.Ap2Client = Ap2Client;
+//# sourceMappingURL=ap2.js.map

package/dist/ap2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ap2.js","sourceRoot":"","sources":["../src/ap2.ts"],"names":[],"mappings":";;;AAQA;;;;GAIG;AACH,MAAa,SAAS;IACS;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C;;;;;;;;OAQG;IACH,KAAK,CAAC,aAAa,CACjB,QAAgB,EAChB,WAAmB,EACnB,OAAe,EACf,SAAiB,EACjB,QAAgB,MAAM;QAEtB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAa,yBAAyB,EAAE;YAC1D;gBACE,SAAS,EAAE,QAAQ;gBACnB,YAAY,EAAE,WAAW;gBACzB,OAAO;gBACP,UAAU,EAAE,SAAS;gBACrB,KAAK;aACN;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB,CACpB,SAAiB,EACjB,MAAc;QAEd,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAmB,4BAA4B,EAAE;YACnE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE;SAClC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAClB,SAAiB,EACjB,eAAuB;QAEvB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAiB,0BAA0B,EAAE;YAC/D,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAe,yBAAyB,EAAE;YAC5D,EAAE,UAAU,EAAE,SAAS,EAAE;SAC1B,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAa,sBAAsB,EAAE;YACvD,EAAE,UAAU,EAAE,SAAS,EAAE;SAC1B,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAe,6BAA6B,EAAE;YAChE,EAAE,SAAS,EAAE,QAAQ,EAAE;SACxB,CAAC,CAAC;IACL,CAAC;CACF;AA5FD,8BA4FC"}

package/dist/app.d.ts

@@ -0,0 +1,186 @@
+import { TenzroClient } from "./client";
+/** Master wallet information derived from the developer's private key. */
+export interface MasterWallet {
+    /** Hex-encoded master wallet address (with 0x prefix) */
+    address: string;
+    /** Hex-encoded public key */
+    publicKey: string;
+}
+/** A user sub-wallet created and funded by the master wallet. */
+export interface UserWallet {
+    /** Hex-encoded user wallet address (with 0x prefix) */
+    address: string;
+    /** Human-readable label */
+    label: string;
+    /** ISO-8601 creation timestamp */
+    createdAt: string;
+    /** Optional spending policy applied to this wallet */
+    spendingPolicy?: SpendingPolicy;
+}
+/** Result of funding a user wallet. */
+export interface FundResult {
+    /** Transaction hash of the funding transfer */
+    txHash: string;
+    /** Amount transferred in wei */
+    amount: bigint;
+}
+/** Spending limits enforced on a user wallet. */
+export interface SpendingPolicy {
+    /** Maximum amount (wei) per 24-hour rolling window */
+    dailyLimit: bigint;
+    /** Maximum amount (wei) per single transaction */
+    perTxLimit: bigint;
+    /** Amount already spent in the current daily window */
+    dailySpent: bigint;
+}
+/** A scoped session key with temporary, limited permissions. */
+export interface SessionKey {
+    /** Unique session identifier */
+    sessionId: string;
+    /** ISO-8601 expiry timestamp */
+    expiresAt: string;
+    /** Allowed operation names (e.g. "transfer", "inference") */
+    operations: string[];
+}
+/** Aggregated usage statistics for the master wallet. */
+export interface UsageStats {
+    /** Total gas spent across all sponsored transactions (wei) */
+    totalGasSpent: bigint;
+    /** Estimated total cost of inference requests (TNZO) */
+    totalInferenceCost: number;
+    /** Total bridge fees paid (wei) */
+    totalBridgeFees: bigint;
+    /** Number of user wallets created */
+    userCount: number;
+    /** Total number of sponsored transactions */
+    transactionCount: number;
+}
+/** Result of a sponsored inference request. */
+export interface InferenceResult {
+    /** Model output text */
+    output: string;
+    /** Number of tokens generated */
+    tokens: number;
+    /** Estimated cost in TNZO */
+    cost: number;
+    /** Model used */
+    modelId: string;
+}
+/** Result of a sponsored agent registration. */
+export interface AgentResult {
+    /** Registered agent ID */
+    agentId: string;
+    /** Agent's wallet address */
+    walletAddress: string;
+}
+/** Result of a sponsored bridge transfer. */
+export interface BridgeResult {
+    /** Bridge transaction hash */
+    txHash: string;
+    /** Current status */
+    status: string;
+}
+/** Result of a sponsored task posting. */
+export interface TaskResult {
+    /** Posted task ID */
+    taskId: string;
+}
+/** Result of a sponsored transaction. */
+export interface TxResult {
+    /** Transaction hash */
+    txHash: string;
+}
+/**
+ * Application client -- the primary interface for developers building on Tenzro.
+ *
+ * Wraps a master wallet and provides methods to:
+ * - Create and fund user wallets
+ * - Sponsor gas for user transactions (paymaster)
+ * - Manage spending policies and session keys
+ * - Track usage and costs
+ *
+ * @example
+ * ```ts
+ * const app = await AppClient.create("https://rpc.tenzro.network", "your-master-wallet-private-key");
+ *
+ * // Create a user wallet (funded from master)
+ * const user = await app.createUserWallet("alice", 100_000_000_000_000_000n);
+ *
+ * // Sponsor an inference request
+ * const result = await app.sponsorInference(user.address, "gemma3-270m", "Hello world");
+ *
+ * // Check usage
+ * const stats = await app.getUsageStats();
+ * console.log("Total gas spent:", stats.totalGasSpent);
+ * ```
+ */
+export declare class AppClient {
+    private rpc;
+    private tenzroClient;
+    private masterWalletInfo;
+    private state;
+    private constructor();
+    /**
+     * Create a new AppClient with a master wallet private key.
+     *
+     * The private key should be the hex-encoded Ed25519 or Secp256k1 key that
+     * controls the developer's master wallet.
+     */
+    static create(rpcUrl: string, masterPrivateKey: string): Promise<AppClient>;
+    /**
+     * Connect using an API key that resolves to a master wallet on the server.
+     */
+    static fromApiKey(rpcUrl: string, apiKey: string): Promise<AppClient>;
+    /**
+     * Create a sub-wallet for a user, funded from the master wallet.
+     *
+     * 1. Creates a new keypair via `tenzro_createWallet`
+     * 2. Transfers `initialFundingWei` TNZO from master to the new wallet
+     * 3. Tracks the user locally for policy enforcement
+     */
+    createUserWallet(label: string, initialFundingWei: bigint): Promise<UserWallet>;
+    /** Fund an existing user wallet from the master wallet. */
+    fundUserWallet(userAddress: string, amountWei: bigint): Promise<FundResult>;
+    /** List all user wallets created by this app. */
+    listUserWallets(): Promise<UserWallet[]>;
+    /**
+     * Set spending limits for a user wallet.
+     * Policies are enforced locally before submitting sponsored transactions.
+     */
+    setUserLimits(userAddress: string, dailyLimit: bigint, perTxLimit: bigint): Promise<SpendingPolicy>;
+    /** Create a session key for a user with scoped permissions and expiry. */
+    createSessionKey(userAddress: string, durationSecs: number, allowedOps: string[]): Promise<SessionKey>;
+    /**
+     * Send a transaction on behalf of a user (master pays gas).
+     */
+    sponsorTransaction(userAddress: string, to: string, amountWei: bigint): Promise<TxResult>;
+    /**
+     * Run inference on behalf of a user (master pays).
+     */
+    sponsorInference(userAddress: string, modelId: string, message: string): Promise<InferenceResult>;
+    /**
+     * Spawn an agent on behalf of a user (master pays).
+     */
+    sponsorAgent(userAddress: string, agentName: string, capabilities: string[]): Promise<AgentResult>;
+    /**
+     * Bridge tokens on behalf of a user (master pays bridge fees).
+     */
+    sponsorBridge(userAddress: string, token: string, fromChain: string, toChain: string, amount: string, recipient: string): Promise<BridgeResult>;
+    /**
+     * Post a task to the marketplace on behalf of a user (master pays budget).
+     */
+    sponsorTask(userAddress: string, title: string, description: string, taskType: string, budgetWei: bigint): Promise<TaskResult>;
+    /** Get master wallet balance in wei. */
+    getMasterBalance(): Promise<bigint>;
+    /**
+     * Get aggregated usage statistics for this app instance.
+     * Statistics are tracked locally since the AppClient was created.
+     */
+    getUsageStats(): Promise<UsageStats>;
+    /** Returns the master wallet information. */
+    get masterWallet(): MasterWallet;
+    /** Get the underlying TenzroClient for advanced operations. */
+    get client(): TenzroClient;
+    private enforceSpendingPolicy;
+}
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

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