stellar-aa-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+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,214 @@
+# SDK for Stellar Account Abstraction Smart Wallet
+
+This package provides the TypeScript SDK for interacting with the Stellar Account Abstraction (AA) Smart Wallet contract on Soroban. It simplifies the process of deploying new smart wallets, managing their ownership, setting up session keys, adding guardians, and facilitating recovery.
+
+## Installation
+
+You can install the SDK using npm:
+
+```bash
+npm install @stellar-aa/sdk
+```
+
+## Usage
+
+The SDK primarily exposes two main classes: `WalletFactory` for deploying new smart wallets and `SmartWallet` for interacting with existing deployed wallets.
+
+### Account Funding Requirements
+
+Before using the SDK, ensure the following accounts are funded:
+
+1. **Source Account** - Required to pay for wallet deployment and owner operations
+2. **Guardian Accounts** - Required if you plan to use the recovery feature (guardians must sign recovery transactions)
+
+For testnet, you can use [Friendbot](https://friendbot.stellar.org) to fund accounts. See examples below.
+
+### `WalletFactory`
+
+Used to deploy new instances of the `SmartWallet` contract.
+
+#### Constructor
+
+`new WalletFactory(config: FactoryConfig)`
+
+-   `config`: An object containing:
+    -   `wasmHash`: The WASM hash of the `smart-wallet` contract to deploy.
+        -   **Testnet WASM Hash**: `8a02111e765f6fc970a95b9af8efc137649a611b2b576a52bfe5c59a0a1a5da0`
+        -   **Mainnet WASM Hash**: `MAINNET_WASM_HASH_HERE` (Not available yet)
+        
+        You can obtain the WASM hash after deploying your `smart-wallet` contract to a specific network (see [`contracts/smart-wallet/README.md`](../contracts/smart-wallet/README.md) for deployment instructions).
+    -   `rpcUrl`: The URL of the Soroban RPC server.
+    -   `networkPassphrase`: The network passphrase (e.g., `Networks.TESTNET`).
+
+#### Methods
+
+##### `createWallet(ownerPublicKey: string, sourceKeypair: StellarSDK.Keypair): Promise<string>`
+
+Deploys a new `SmartWallet` contract and initializes it with the specified `ownerPublicKey`.
+
+-   `ownerPublicKey`: The public key of the account that will be the initial owner of the smart wallet.
+-   `sourceKeypair`: A `StellarSDK.Keypair` of an account that will pay for the deployment transaction and sign it. This account needs to be funded.
+-   Returns: A `Promise` that resolves to the `contractId` of the newly deployed smart wallet.
+
+**Example:**
+
+```typescript
+import { WalletFactory, StellarSDK } from '@stellar-aa/sdk';
+
+const { Keypair, Networks } = StellarSDK;
+
+const rpcUrl = "https://soroban-testnet.stellar.org";
+const networkPassphrase = Networks.TESTNET;
+const wasmHash = "8a02111e765f6fc970a95b9af8efc137649a611b2b576a52bfe5c59a0a1a5da0"; // Testnet WASM hash
+
+// Helper to fund account via Friendbot (Testnet only)
+async function fundAccount(publicKey: string) {
+    const response = await fetch(
+        `https://friendbot.stellar.org?addr=${encodeURIComponent(publicKey)}`
+    );
+    if (!response.ok) throw new Error("Failed to fund account");
+    await response.json();
+    await new Promise(resolve => setTimeout(resolve, 3000));
+}
+
+async function deployNewWallet() {
+    const factory = new WalletFactory({ wasmHash, rpcUrl, networkPassphrase });
+
+    const ownerKeypair = Keypair.random();
+    const sourceKeypair = Keypair.random();
+
+    // Fund the source account (required to pay for deployment)
+    await fundAccount(sourceKeypair.publicKey());
+
+    console.log("Deploying wallet for owner:", ownerKeypair.publicKey());
+    const contractId = await factory.createWallet(ownerKeypair.publicKey(), sourceKeypair);
+    console.log("Deployed Smart Wallet with ID:", contractId);
+
+    return { contractId, ownerKeypair };
+}
+
+// deployNewWallet().catch(console.error);
+```
+
+### `SmartWallet`
+
+Used to interact with an already deployed `SmartWallet` contract.
+
+#### Constructor
+
+`new SmartWallet(config: WalletConfig)`
+
+-   `config`: An object containing:
+    -   `contractId`: The contract ID of the deployed `SmartWallet`.
+    -   `rpcUrl`: The URL of the Soroban RPC server.
+    -   `networkPassphrase`: The network passphrase.
+
+#### Methods
+
+##### Owner Operations
+
+These operations require the `sourceKeypair` to be the current owner of the `SmartWallet`.
+
+-   `initialize(ownerPublicKey: string, sourceKeypair: StellarSDK.Keypair): Promise<GetTransactionResponse>`
+    Initializes the wallet. This should only be called once after deployment. `WalletFactory.createWallet` handles this automatically.
+
+-   `execute(targetContractId: string, functionName: string, args: unknown[], sourceKeypair: StellarSDK.Keypair): Promise<GetTransactionResponse>`
+    Allows the `SmartWallet` owner to execute an arbitrary function on another Soroban contract.
+
+-   `addGuardians(guardianAddresses: string[], sourceKeypair: StellarSDK.Keypair): Promise<GetTransactionResponse>`
+    Adds new public keys to the list of guardians for recovery.
+
+##### Session Operations
+
+-   `createSession(sessionKeyPublicKey: string, limit: string, durationSeconds: number, sourceKeypair: StellarSDK.Keypair): Promise<GetTransactionResponse>`
+    Creates a new session key with a defined spending `limit` (in stroops) and `durationSeconds`. The `sourceKeypair` must be the owner.
+
+-   `executeSession(sessionKeyPublicKey: string, targetContractId: string, functionName: string, args: unknown[], amount: string, sourceKeypair: StellarSDK.Keypair): Promise<GetTransactionResponse>`
+    Executes a contract call using a session key. The `sourceKeypair` must be the session keypair. The `amount` represents the value being spent against the session's limit.
+
+##### Recovery Operations
+
+-   `recover(newOwnerPublicKey: string, guardian1PublicKey: string, guardian2PublicKey: string, guardian1Keypair: StellarSDK.Keypair, guardian2Keypair: StellarSDK.Keypair): Promise<GetTransactionResponse>`
+    Recovers the wallet by setting a `newOwnerPublicKey`. This requires two guardians to sign the transaction. The method uses Soroban's authorization framework with `authorizeEntry` to properly sign multi-party auth requirements.
+
+##### View Functions (Read-only)
+
+These methods perform simulations and do not require transaction signing.
+
+-   `getOwner(): Promise<string>`
+    Returns the public key of the current owner of the `SmartWallet`.
+
+-   `getGuardians(): Promise<string[]>`
+    Returns an array of public keys of the registered guardians.
+
+-   `getSession(sessionKeyPublicKey: string): Promise<Session | null>`
+    Returns the details of a specific session key, or `null` if not found.
+
+### Example Usage (Continued from Factory Deployment)
+
+```typescript
+import { SmartWallet, StellarSDK } from '@stellar-aa/sdk';
+
+// Assuming contractId and ownerKeypair are obtained from WalletFactory.createWallet()
+const { contractId, ownerKeypair } = await deployNewWallet(); // Call the example from above
+
+const rpcUrl = "https://soroban-testnet.stellar.org";
+const networkPassphrase = StellarSDK.Networks.TESTNET;
+
+async function interactWithWallet(contractId: string, ownerKeypair: StellarSDK.Keypair) {
+    const smartWallet = new SmartWallet({ contractId, rpcUrl, networkPassphrase });
+
+    console.log("\n--- Interacting with Smart Wallet ---");
+
+    // Get Owner
+    const owner = await smartWallet.getOwner();
+    console.log("Current Owner:", owner);
+
+    // Add Guardians
+    // NOTE: Guardian accounts must be funded before they can sign recovery transactions
+    const guardian1Keypair = StellarSDK.Keypair.random();
+    const guardian2Keypair = StellarSDK.Keypair.random();
+
+    // Fund guardians (required for recovery)
+    await fundAccount(guardian1Keypair.publicKey());
+    await fundAccount(guardian2Keypair.publicKey());
+
+    await smartWallet.addGuardians(
+        [guardian1Keypair.publicKey(), guardian2Keypair.publicKey()],
+        ownerKeypair
+    );
+    console.log("Guardians added:", await smartWallet.getGuardians());
+
+    // Create Session
+    const sessionKeypair = StellarSDK.Keypair.random();
+    await smartWallet.createSession(
+        sessionKeypair.publicKey(),
+        "5000000", // 5 XLM limit
+        3600,      // 1 hour duration
+        ownerKeypair
+    );
+    console.log("Session created for:", sessionKeypair.publicKey());
+    console.log("Session info:", await smartWallet.getSession(sessionKeypair.publicKey()));
+
+    // Recover Wallet
+    const newOwnerKeypair = StellarSDK.Keypair.random();
+    console.log("Initiating recovery with new owner:", newOwnerKeypair.publicKey());
+    await smartWallet.recover(
+        newOwnerKeypair.publicKey(),
+        guardian1Keypair.publicKey(),
+        guardian2Keypair.publicKey(),
+        guardian1Keypair,
+        guardian2Keypair
+    );
+    console.log("Wallet recovered. New owner is:", await smartWallet.getOwner());
+}
+
+// interactWithWallet(contractId, ownerKeypair).catch(console.error);
+```
+
+## Types and Utilities
+
+The SDK also re-exports `StellarSDK` for convenience and provides utility functions from `soroban-utils.ts` for common Soroban transaction patterns, although these are mostly used internally by `SmartWallet` and `WalletFactory`. Key types like `Session`, `WalletConfig`, and `FactoryConfig` are also exported.
+
+---
+**Note**: For a complete working example, refer to the [`sdk-test/test.ts`](../sdk-test/test.ts) file, which demonstrates the full lifecycle and interaction patterns.

package/dist/SmartWallet.d.ts

@@ -0,0 +1,32 @@
+import * as StellarSDK from "@stellar/stellar-sdk";
+import { Session, WalletConfig, GetTransactionResponse } from "./types";
+/**
+ * SmartWallet - Account abstraction for Stellar
+ */
+export declare class SmartWallet {
+    private contract;
+    private server;
+    private networkPassphrase;
+    constructor(config: WalletConfig);
+    /** Build and submit a contract call transaction */
+    private callContract;
+    /** Convert unknown args to ScVal */
+    private toScArgs;
+    /** Sign auth entries for multi-signer transactions */
+    private signAuthEntries;
+    /** Initialize wallet with owner */
+    initialize(ownerPublicKey: string, sourceKeypair: StellarSDK.Keypair): Promise<GetTransactionResponse>;
+    /** Execute contract call (owner only) */
+    execute(targetContractId: string, functionName: string, args: unknown[], sourceKeypair: StellarSDK.Keypair): Promise<GetTransactionResponse>;
+    /** Add guardians (owner only) */
+    addGuardians(guardianAddresses: string[], sourceKeypair: StellarSDK.Keypair): Promise<GetTransactionResponse>;
+    /** Create session key (owner only) */
+    createSession(sessionKeyPublicKey: string, limit: string, durationSeconds: number, sourceKeypair: StellarSDK.Keypair): Promise<GetTransactionResponse>;
+    /** Execute using session key */
+    executeSession(sessionKeyPublicKey: string, targetContractId: string, functionName: string, args: unknown[], amount: string, sourceKeypair: StellarSDK.Keypair): Promise<GetTransactionResponse>;
+    recover(newOwnerPublicKey: string, guardian1PublicKey: string, guardian2PublicKey: string, guardian1Keypair: StellarSDK.Keypair, guardian2Keypair: StellarSDK.Keypair): Promise<GetTransactionResponse>;
+    getOwner(): Promise<string>;
+    getGuardians(): Promise<string[]>;
+    getSession(sessionKeyPublicKey: string): Promise<Session | null>;
+}
+//# sourceMappingURL=SmartWallet.d.ts.map

package/dist/SmartWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartWallet.d.ts","sourceRoot":"","sources":["../src/SmartWallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,sBAAsB,CAAC;AACnD,OAAO,EACL,OAAO,EACP,YAAY,EAGZ,sBAAsB,EAGvB,MAAM,SAAS,CAAC;AAajB;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,MAAM,EAAE,YAAY;IAUhC,mDAAmD;YACrC,YAAY;IAmB1B,oCAAoC;IACpC,OAAO,CAAC,QAAQ;IAMhB,sDAAsD;YACxC,eAAe;IA4B7B,mCAAmC;IAC7B,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,CAAC,OAAO;IAQ1E,yCAAyC;IACnC,OAAO,CACX,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,OAAO,EAAE,EACf,aAAa,EAAE,UAAU,CAAC,OAAO;IAanC,iCAAiC;IAC3B,YAAY,CAChB,iBAAiB,EAAE,MAAM,EAAE,EAC3B,aAAa,EAAE,UAAU,CAAC,OAAO;IAcnC,sCAAsC;IAChC,aAAa,CACjB,mBAAmB,EAAE,MAAM,EAC3B,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,UAAU,CAAC,OAAO;IAanC,gCAAgC;IAC1B,cAAc,CAClB,mBAAmB,EAAE,MAAM,EAC3B,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,OAAO,EAAE,EACf,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,UAAU,CAAC,OAAO;IAiB7B,OAAO,CACX,iBAAiB,EAAE,MAAM,EACzB,kBAAkB,EAAE,MAAM,EAC1B,kBAAkB,EAAE,MAAM,EAC1B,gBAAgB,EAAE,UAAU,CAAC,OAAO,EACpC,gBAAgB,EAAE,UAAU,CAAC,OAAO,GACnC,OAAO,CAAC,sBAAsB,CAAC;IAwD5B,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAS3B,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IASjC,UAAU,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;CASvE"}

package/dist/SmartWallet.js

@@ -0,0 +1,168 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmartWallet = void 0;
+const StellarSDK = __importStar(require("@stellar/stellar-sdk"));
+const types_1 = require("./types");
+const soroban_utils_1 = require("./soroban-utils");
+const { Contract, TransactionBuilder, BASE_FEE, Address, nativeToScVal } = StellarSDK;
+// Cache the SDK type cast
+const stellarWithRpc = StellarSDK;
+/**
+ * SmartWallet - Account abstraction for Stellar
+ */
+class SmartWallet {
+    constructor(config) {
+        this.contract = new Contract(config.contractId);
+        const rpc = stellarWithRpc.rpc;
+        if (!rpc?.Server)
+            throw new Error("SorobanRpc.Server not found in SDK");
+        this.server = new rpc.Server(config.rpcUrl);
+        this.networkPassphrase = config.networkPassphrase;
+    }
+    /* Private helpers */
+    /** Build and submit a contract call transaction */
+    async callContract(method, args, sourceKeypair) {
+        const sourceAccount = await this.server.getAccount(sourceKeypair.publicKey());
+        const tx = new TransactionBuilder(sourceAccount, {
+            fee: BASE_FEE,
+            networkPassphrase: this.networkPassphrase,
+        })
+            .addOperation(this.contract.call(method, ...args))
+            .setTimeout(30)
+            .build();
+        return (0, soroban_utils_1.submitTransaction)(tx, sourceKeypair, this.server);
+    }
+    /** Convert unknown args to ScVal */
+    toScArgs(args) {
+        return args.map((arg) => typeof arg === "string" ? nativeToScVal(arg) : arg);
+    }
+    /** Sign auth entries for multi-signer transactions */
+    async signAuthEntries(authEntries, signers, ledger) {
+        return Promise.all(authEntries.map(async (entry) => {
+            const creds = entry.credentials();
+            if (creds.switch().name !== "sorobanCredentialsAddress")
+                return entry;
+            const pubKey = StellarSDK.Address.fromScAddress(creds.address().address()).toString();
+            const signer = signers[pubKey];
+            if (!signer)
+                return entry;
+            return StellarSDK.authorizeEntry(entry, signer, ledger + 100, this.networkPassphrase);
+        }));
+    }
+    /* Owner Operations */
+    /** Initialize wallet with owner */
+    async initialize(ownerPublicKey, sourceKeypair) {
+        return this.callContract(types_1.ContractMethod.Initialize, [new Address(ownerPublicKey).toScVal()], sourceKeypair);
+    }
+    /** Execute contract call (owner only) */
+    async execute(targetContractId, functionName, args, sourceKeypair) {
+        return this.callContract(types_1.ContractMethod.Execute, [
+            new Address(targetContractId).toScVal(),
+            nativeToScVal(functionName, { type: "symbol" }),
+            nativeToScVal(this.toScArgs(args), { type: "vec" }),
+        ], sourceKeypair);
+    }
+    /** Add guardians (owner only) */
+    async addGuardians(guardianAddresses, sourceKeypair) {
+        const addresses = guardianAddresses.map((addr) => new Address(addr).toScVal());
+        return this.callContract(types_1.ContractMethod.AddGuardians, [nativeToScVal(addresses, { type: "vec" })], sourceKeypair);
+    }
+    /* Session operations */
+    /** Create session key (owner only) */
+    async createSession(sessionKeyPublicKey, limit, durationSeconds, sourceKeypair) {
+        return this.callContract(types_1.ContractMethod.CreateSession, [
+            new Address(sessionKeyPublicKey).toScVal(),
+            nativeToScVal(BigInt(limit), { type: "i128" }),
+            nativeToScVal(durationSeconds, { type: "u64" }),
+        ], sourceKeypair);
+    }
+    /** Execute using session key */
+    async executeSession(sessionKeyPublicKey, targetContractId, functionName, args, amount, sourceKeypair) {
+        return this.callContract(types_1.ContractMethod.ExecuteSession, [
+            new Address(sessionKeyPublicKey).toScVal(),
+            new Address(targetContractId).toScVal(),
+            nativeToScVal(functionName, { type: "symbol" }),
+            nativeToScVal(this.toScArgs(args), { type: "vec" }),
+            nativeToScVal(BigInt(amount), { type: "i128" }),
+        ], sourceKeypair);
+    }
+    /* Recovery (requires 2 guardian signatures) */
+    async recover(newOwnerPublicKey, guardian1PublicKey, guardian2PublicKey, guardian1Keypair, guardian2Keypair) {
+        const sourceAccount = await this.server.getAccount(guardian1Keypair.publicKey());
+        // Build transaction
+        const tx = new TransactionBuilder(sourceAccount, {
+            fee: BASE_FEE,
+            networkPassphrase: this.networkPassphrase,
+        })
+            .addOperation(this.contract.call(types_1.ContractMethod.Recover, new Address(newOwnerPublicKey).toScVal(), new Address(guardian1PublicKey).toScVal(), new Address(guardian2PublicKey).toScVal()))
+            .setTimeout(30)
+            .build();
+        // Simulate and validate
+        const sim = await this.server.simulateTransaction(tx);
+        if (!stellarWithRpc.rpc.Api.isSimulationSuccess(sim)) {
+            throw new Error(`Simulation failed: ${JSON.stringify(sim)}`);
+        }
+        const simAny = sim;
+        const authEntries = simAny.result?.auth || [];
+        if (!authEntries.length)
+            throw new Error("No auth entries in simulation");
+        // Sign auth entries with both guardians
+        const signedAuth = await this.signAuthEntries(authEntries, {
+            [guardian1PublicKey]: guardian1Keypair,
+            [guardian2PublicKey]: guardian2Keypair,
+        }, simAny.latestLedger || 0);
+        // Assemble with signed auth and submit
+        const modifiedSim = {
+            ...simAny,
+            result: { ...simAny.result, auth: signedAuth },
+        };
+        const assembled = stellarWithRpc.rpc.assembleTransaction(tx, modifiedSim).build();
+        assembled.sign(guardian1Keypair);
+        return (0, soroban_utils_1.submitSignedTransaction)(assembled, this.server);
+    }
+    /* View functions (read-only) */
+    async getOwner() {
+        return (0, soroban_utils_1.executeSimulation)(this.contract, this.server, this.networkPassphrase, types_1.ContractMethod.GetOwner);
+    }
+    async getGuardians() {
+        return (0, soroban_utils_1.executeSimulation)(this.contract, this.server, this.networkPassphrase, types_1.ContractMethod.GetGuardians);
+    }
+    async getSession(sessionKeyPublicKey) {
+        return (0, soroban_utils_1.executeSimulation)(this.contract, this.server, this.networkPassphrase, types_1.ContractMethod.GetSession, new Address(sessionKeyPublicKey).toScVal());
+    }
+}
+exports.SmartWallet = SmartWallet;
+//# sourceMappingURL=SmartWallet.js.map

package/dist/SmartWallet.js.map

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

package/dist/WalletFactory.d.ts

@@ -0,0 +1,26 @@
+import * as StellarSDK from '@stellar/stellar-sdk';
+import { FactoryConfig } from './types';
+/**
+ * Factory for creating new SmartWallet instances
+ * - Deploys a new contract instance for each user from the pre-deployed WASM
+ */
+export declare class WalletFactory {
+    private wasmHash;
+    private server;
+    private networkPassphrase;
+    private rpcUrl;
+    constructor(config: FactoryConfig);
+    /**
+     * Creates a new SmartWallet instance for a user
+     * @param ownerPublicKey - The public key that will own this wallet
+     * @param sourceKeypair - Keypair to pay for deployment and sign transactions
+     * @returns The contract ID of the newly deployed wallet
+     */
+    createWallet(ownerPublicKey: string, sourceKeypair: StellarSDK.Keypair): Promise<string>;
+    /**
+     * Deploy a new contract instance from the WASM hash
+     * @private
+     */
+    private deployInstance;
+}
+//# sourceMappingURL=WalletFactory.d.ts.map

package/dist/WalletFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalletFactory.d.ts","sourceRoot":"","sources":["../src/WalletFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAGL,aAAa,EACd,MAAM,SAAS,CAAC;AAQjB;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,aAAa;IAcjC;;;;;OAKG;IACG,YAAY,CAChB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,UAAU,CAAC,OAAO,GAChC,OAAO,CAAC,MAAM,CAAC;IAgBlB;;;OAGG;YACW,cAAc;CA6C7B"}

package/dist/WalletFactory.js

@@ -0,0 +1,114 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletFactory = void 0;
+const StellarSDK = __importStar(require("@stellar/stellar-sdk"));
+const SmartWallet_1 = require("./SmartWallet");
+const soroban_utils_1 = require("./soroban-utils");
+const { TransactionBuilder, Operation, } = StellarSDK;
+/**
+ * Factory for creating new SmartWallet instances
+ * - Deploys a new contract instance for each user from the pre-deployed WASM
+ */
+class WalletFactory {
+    constructor(config) {
+        this.wasmHash = config.wasmHash;
+        this.rpcUrl = config.rpcUrl;
+        this.networkPassphrase = config.networkPassphrase;
+        // Access the RPC server
+        const stellarWithRpc = StellarSDK;
+        const rpc = stellarWithRpc.rpc;
+        if (!rpc?.Server) {
+            throw new Error('SorobanRpc.Server not found in SDK');
+        }
+        this.server = new rpc.Server(config.rpcUrl);
+    }
+    /**
+     * Creates a new SmartWallet instance for a user
+     * @param ownerPublicKey - The public key that will own this wallet
+     * @param sourceKeypair - Keypair to pay for deployment and sign transactions
+     * @returns The contract ID of the newly deployed wallet
+     */
+    async createWallet(ownerPublicKey, sourceKeypair) {
+        // 1. Deploy new contract instance from WASM hash
+        const contractId = await this.deployInstance(sourceKeypair);
+        // 2. Initialize the wallet with the owner
+        const wallet = new SmartWallet_1.SmartWallet({
+            contractId,
+            rpcUrl: this.rpcUrl,
+            networkPassphrase: this.networkPassphrase,
+        });
+        await wallet.initialize(ownerPublicKey, sourceKeypair);
+        return contractId;
+    }
+    /**
+     * Deploy a new contract instance from the WASM hash
+     * @private
+     */
+    async deployInstance(sourceKeypair) {
+        const sourceAccount = await this.server.getAccount(sourceKeypair.publicKey());
+        // Build deployment transaction using invokeHostFunction
+        const tx = new TransactionBuilder(sourceAccount, {
+            fee: '10000000', // Higher fee for deployment
+            networkPassphrase: this.networkPassphrase,
+        })
+            .addOperation(Operation.invokeHostFunction({
+            func: StellarSDK.xdr.HostFunction.hostFunctionTypeCreateContract(new StellarSDK.xdr.CreateContractArgs({
+                contractIdPreimage: StellarSDK.xdr.ContractIdPreimage.contractIdPreimageFromAddress(new StellarSDK.xdr.ContractIdPreimageFromAddress({
+                    address: new StellarSDK.Address(sourceKeypair.publicKey()).toScAddress(),
+                    salt: StellarSDK.Keypair.random().rawPublicKey(),
+                })),
+                executable: StellarSDK.xdr.ContractExecutable.contractExecutableWasm(Buffer.from(this.wasmHash, 'hex')),
+            })),
+            auth: [],
+        }))
+            .setTimeout(30)
+            .build();
+        // Sign and submit
+        const prepared = await this.server.prepareTransaction(tx);
+        prepared.sign(sourceKeypair);
+        const result = await (0, soroban_utils_1.submitSignedTransaction)(prepared, this.server);
+        // Extract contract ID from the transaction result
+        if (result.returnValue) {
+            // The return value is an ScAddress which needs to be converted
+            const scValToNative = StellarSDK.scValToNative;
+            const contractId = scValToNative(result.returnValue);
+            return contractId;
+        }
+        throw new Error('Failed to extract contract ID from deployment result');
+    }
+}
+exports.WalletFactory = WalletFactory;
+//# sourceMappingURL=WalletFactory.js.map

package/dist/WalletFactory.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { SmartWallet } from './SmartWallet';
+export { WalletFactory } from './WalletFactory';
+export * from './soroban-utils';
+export { Session, WalletConfig, FactoryConfig, ContractMethod } from './types';
+export * as StellarSDK from '@stellar/stellar-sdk';
+//# 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,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG/E,OAAO,KAAK,UAAU,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,51 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StellarSDK = exports.ContractMethod = exports.WalletFactory = exports.SmartWallet = void 0;
+// Main SDK exports
+var SmartWallet_1 = require("./SmartWallet");
+Object.defineProperty(exports, "SmartWallet", { enumerable: true, get: function () { return SmartWallet_1.SmartWallet; } });
+var WalletFactory_1 = require("./WalletFactory");
+Object.defineProperty(exports, "WalletFactory", { enumerable: true, get: function () { return WalletFactory_1.WalletFactory; } });
+__exportStar(require("./soroban-utils"), exports);
+// Type exports
+var types_1 = require("./types");
+Object.defineProperty(exports, "ContractMethod", { enumerable: true, get: function () { return types_1.ContractMethod; } });
+// Re-export Stellar SDK for convenience
+exports.StellarSDK = __importStar(require("@stellar/stellar-sdk"));
+//# 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,mBAAmB;AACnB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,kDAAgC;AAEhC,eAAe;AACf,iCAA+E;AAAhC,uGAAA,cAAc,OAAA;AAE7D,wCAAwC;AACxC,mEAAmD"}

package/dist/soroban-utils.d.ts

@@ -0,0 +1,27 @@
+import * as StellarSDK from '@stellar/stellar-sdk';
+import { GetTransactionResponse, SorobanRpcServer, ContractMethod, ScVal } from './types';
+/**
+ * Submit a transaction and wait for confirmation
+ */
+export declare function submitTransaction(tx: StellarSDK.Transaction, sourceKeypair: StellarSDK.Keypair, server: SorobanRpcServer): Promise<GetTransactionResponse>;
+/**
+ * Submit an already signed transaction
+ */
+export declare function submitSignedTransaction(tx: StellarSDK.Transaction, server: SorobanRpcServer): Promise<GetTransactionResponse>;
+/**
+ * Build a transaction with standard configuration
+ */
+export declare function buildTransaction(contract: StellarSDK.Contract, server: SorobanRpcServer, networkPassphrase: string, sourceAccount: StellarSDK.Account, method: ContractMethod, ...args: ScVal[]): Promise<StellarSDK.Transaction>;
+/**
+ * Build and submit a transaction
+ */
+export declare function buildAndSubmitTransaction(contract: StellarSDK.Contract, server: SorobanRpcServer, networkPassphrase: string, sourceKeypair: StellarSDK.Keypair, method: ContractMethod, ...args: ScVal[]): Promise<GetTransactionResponse>;
+/**
+ * Build a transaction for simulation (read-only queries)
+ */
+export declare function buildSimulationTransaction(contract: StellarSDK.Contract, server: SorobanRpcServer, networkPassphrase: string, method: ContractMethod, ...args: ScVal[]): Promise<StellarSDK.Transaction>;
+/**
+ * Execute simulation and extract result
+ */
+export declare function executeSimulation<T>(contract: StellarSDK.Contract, server: SorobanRpcServer, networkPassphrase: string, method: ContractMethod, ...args: ScVal[]): Promise<T>;
+//# sourceMappingURL=soroban-utils.d.ts.map

package/dist/soroban-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"soroban-utils.d.ts","sourceRoot":"","sources":["../src/soroban-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,sBAAsB,CAAC;AACnD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAEhB,cAAc,EACd,KAAK,EACN,MAAM,SAAS,CAAC;AAQjB;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,UAAU,CAAC,WAAW,EAC1B,aAAa,EAAE,UAAU,CAAC,OAAO,EACjC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAKjC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,UAAU,CAAC,WAAW,EAC1B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAqDjC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAC7B,MAAM,EAAE,gBAAgB,EACxB,iBAAiB,EAAE,MAAM,EACzB,aAAa,EAAE,UAAU,CAAC,OAAO,EACjC,MAAM,EAAE,cAAc,EACtB,GAAG,IAAI,EAAE,KAAK,EAAE,GACf,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAQjC;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAC7B,MAAM,EAAE,gBAAgB,EACxB,iBAAiB,EAAE,MAAM,EACzB,aAAa,EAAE,UAAU,CAAC,OAAO,EACjC,MAAM,EAAE,cAAc,EACtB,GAAG,IAAI,EAAE,KAAK,EAAE,GACf,OAAO,CAAC,sBAAsB,CAAC,CAWjC;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAC7B,MAAM,EAAE,gBAAgB,EACxB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,cAAc,EACtB,GAAG,IAAI,EAAE,KAAK,EAAE,GACf,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAiBjC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAC7B,MAAM,EAAE,gBAAgB,EACxB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,cAAc,EACtB,GAAG,IAAI,EAAE,KAAK,EAAE,GACf,OAAO,CAAC,CAAC,CAAC,CAkBZ"}

package/dist/soroban-utils.js

@@ -0,0 +1,142 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.submitTransaction = submitTransaction;
+exports.submitSignedTransaction = submitSignedTransaction;
+exports.buildTransaction = buildTransaction;
+exports.buildAndSubmitTransaction = buildAndSubmitTransaction;
+exports.buildSimulationTransaction = buildSimulationTransaction;
+exports.executeSimulation = executeSimulation;
+const StellarSDK = __importStar(require("@stellar/stellar-sdk"));
+const { TransactionBuilder, BASE_FEE, scValToNative, } = StellarSDK;
+/**
+ * Submit a transaction and wait for confirmation
+ */
+async function submitTransaction(tx, sourceKeypair, server) {
+    const prepared = await server.prepareTransaction(tx);
+    prepared.sign(sourceKeypair);
+    return await submitSignedTransaction(prepared, server);
+}
+/**
+ * Submit an already signed transaction
+ */
+async function submitSignedTransaction(tx, server) {
+    const sendResponse = await server.sendTransaction(tx);
+    const stellarWithRpc = StellarSDK;
+    const GetTransactionStatus = stellarWithRpc.rpc.Api.GetTransactionStatus;
+    if (sendResponse.status === 'PENDING') {
+        let getResponse = await server.getTransaction(sendResponse.hash);
+        let attempts = 0;
+        const maxAttempts = 30; // 30 seconds max
+        while (getResponse.status === GetTransactionStatus.NOT_FOUND &&
+            attempts < maxAttempts) {
+            await new Promise((resolve) => setTimeout(resolve, 1000));
+            getResponse = await server.getTransaction(sendResponse.hash);
+            attempts++;
+        }
+        if (getResponse.status === GetTransactionStatus.SUCCESS) {
+            return getResponse;
+        }
+        else if (getResponse.status === GetTransactionStatus.FAILED) {
+            throw new Error(`Transaction failed: ${JSON.stringify(getResponse.resultXdr || 'Unknown error')}`);
+        }
+        else if (getResponse.status === GetTransactionStatus.NOT_FOUND) {
+            throw new Error('Transaction timed out - not found after 30 seconds');
+        }
+        else {
+            throw new Error(`Transaction ended with status: ${getResponse.status}`);
+        }
+    }
+    else if (sendResponse.status === 'ERROR') {
+        // Extract error details from the response
+        let errorMessage = 'Unknown error';
+        // The response may have errorResult with detailed error info (not in types)
+        const errorResult = sendResponse.errorResult;
+        if (errorResult?._attributes?.result?._switch?.name) {
+            errorMessage = errorResult._attributes.result._switch.name;
+        }
+        else if (sendResponse.errorResultXdr) {
+            errorMessage = `XDR: ${sendResponse.errorResultXdr}`;
+        }
+        throw new Error(`Transaction submission error: ${errorMessage}`);
+    }
+    else {
+        throw new Error(`Unexpected transaction status: ${sendResponse.status}`);
+    }
+}
+/**
+ * Build a transaction with standard configuration
+ */
+async function buildTransaction(contract, server, networkPassphrase, sourceAccount, method, ...args) {
+    return new TransactionBuilder(sourceAccount, {
+        fee: BASE_FEE,
+        networkPassphrase: networkPassphrase,
+    })
+        .addOperation(contract.call(method, ...args))
+        .setTimeout(30)
+        .build();
+}
+/**
+ * Build and submit a transaction
+ */
+async function buildAndSubmitTransaction(contract, server, networkPassphrase, sourceKeypair, method, ...args) {
+    const sourceAccount = await server.getAccount(sourceKeypair.publicKey());
+    const tx = await buildTransaction(contract, server, networkPassphrase, sourceAccount, method, ...args);
+    return await submitTransaction(tx, sourceKeypair, server);
+}
+/**
+ * Build a transaction for simulation (read-only queries)
+ */
+async function buildSimulationTransaction(contract, server, networkPassphrase, method, ...args) {
+    // Use a dummy account for simulation
+    const stellarWithRpc = StellarSDK;
+    const Account = stellarWithRpc.Account;
+    const dummyAccount = new Account('GAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWHF', '0');
+    return await buildTransaction(contract, server, networkPassphrase, dummyAccount, method, ...args);
+}
+/**
+ * Execute simulation and extract result
+ */
+async function executeSimulation(contract, server, networkPassphrase, method, ...args) {
+    const tx = await buildSimulationTransaction(contract, server, networkPassphrase, method, ...args);
+    const simulated = await server.simulateTransaction(tx);
+    const stellarWithRpc = StellarSDK;
+    const Api = stellarWithRpc.rpc.Api;
+    if (Api.isSimulationSuccess(simulated)) {
+        return scValToNative(simulated.result.retval);
+    }
+    throw new Error(`Failed to execute ${method}`);
+}
+//# sourceMappingURL=soroban-utils.js.map

package/dist/soroban-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"soroban-utils.js","sourceRoot":"","sources":["../src/soroban-utils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,8CASC;AAKD,0DAwDC;AAKD,4CAeC;AAKD,8DAkBC;AAKD,gEAuBC;AAKD,8CAwBC;AA5LD,iEAAmD;AASnD,MAAM,EACJ,kBAAkB,EAClB,QAAQ,EACR,aAAa,GACd,GAAG,UAAU,CAAC;AAEf;;GAEG;AACI,KAAK,UAAU,iBAAiB,CACrC,EAA0B,EAC1B,aAAiC,EACjC,MAAwB;IAExB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACrD,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAE7B,OAAO,MAAM,uBAAuB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,uBAAuB,CAC3C,EAA0B,EAC1B,MAAwB;IAExB,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IACtD,MAAM,cAAc,GAAG,UAA0C,CAAC;IAClE,MAAM,oBAAoB,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAEzE,IAAI,YAAY,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACtC,IAAI,WAAW,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACjE,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,MAAM,WAAW,GAAG,EAAE,CAAC,CAAC,iBAAiB;QAEzC,OACE,WAAW,CAAC,MAAM,KAAK,oBAAoB,CAAC,SAAS;YACrD,QAAQ,GAAG,WAAW,EACtB,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1D,WAAW,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAC7D,QAAQ,EAAE,CAAC;QACb,CAAC;QAED,IAAI,WAAW,CAAC,MAAM,KAAK,oBAAoB,CAAC,OAAO,EAAE,CAAC;YACxD,OAAO,WAAW,CAAC;QAErB,CAAC;aAAM,IAAI,WAAW,CAAC,MAAM,KAAK,oBAAoB,CAAC,MAAM,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CACb,uBAAuB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,IAAI,eAAe,CAAC,EAAE,CAClF,CAAC;QAEJ,CAAC;aAAM,IAAI,WAAW,CAAC,MAAM,KAAK,oBAAoB,CAAC,SAAS,EAAE,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QAExE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,kCAAkC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1E,CAAC;IAEH,CAAC;SAAM,IAAI,YAAY,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC3C,0CAA0C;QAC1C,IAAI,YAAY,GAAG,eAAe,CAAC;QAEnC,4EAA4E;QAC5E,MAAM,WAAW,GAAI,YAAoB,CAAC,WAAW,CAAC;QACtD,IAAI,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACpD,YAAY,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;QAC7D,CAAC;aAAM,IAAI,YAAY,CAAC,cAAc,EAAE,CAAC;YACvC,YAAY,GAAG,QAAQ,YAAY,CAAC,cAAc,EAAE,CAAC;QACvD,CAAC;QAED,MAAM,IAAI,KAAK,CACb,iCAAiC,YAAY,EAAE,CAChD,CAAC;IAEJ,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,kCAAkC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,gBAAgB,CACpC,QAA6B,EAC7B,MAAwB,EACxB,iBAAyB,EACzB,aAAiC,EACjC,MAAsB,EACtB,GAAG,IAAa;IAEhB,OAAO,IAAI,kBAAkB,CAAC,aAAa,EAAE;QAC3C,GAAG,EAAE,QAAQ;QACb,iBAAiB,EAAE,iBAAiB;KACrC,CAAC;SACC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;SAC5C,UAAU,CAAC,EAAE,CAAC;SACd,KAAK,EAAE,CAAC;AACb,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,yBAAyB,CAC7C,QAA6B,EAC7B,MAAwB,EACxB,iBAAyB,EACzB,aAAiC,EACjC,MAAsB,EACtB,GAAG,IAAa;IAEhB,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC;IACzE,MAAM,EAAE,GAAG,MAAM,gBAAgB,CAC/B,QAAQ,EACR,MAAM,EACN,iBAAiB,EACjB,aAAa,EACb,MAAM,EACN,GAAG,IAAI,CACR,CAAC;IACF,OAAO,MAAM,iBAAiB,CAAC,EAAE,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,0BAA0B,CAC9C,QAA6B,EAC7B,MAAwB,EACxB,iBAAyB,EACzB,MAAsB,EACtB,GAAG,IAAa;IAEhB,qCAAqC;IACrC,MAAM,cAAc,GAAG,UAA0C,CAAC;IAClE,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC;IACvC,MAAM,YAAY,GAAG,IAAI,OAAO,CAC9B,0DAA0D,EAC1D,GAAG,CACJ,CAAC;IAEF,OAAO,MAAM,gBAAgB,CAC3B,QAAQ,EACR,MAAM,EACN,iBAAiB,EACjB,YAAY,EACZ,MAAM,EACN,GAAG,IAAI,CACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,iBAAiB,CACrC,QAA6B,EAC7B,MAAwB,EACxB,iBAAyB,EACzB,MAAsB,EACtB,GAAG,IAAa;IAEhB,MAAM,EAAE,GAAG,MAAM,0BAA0B,CACzC,QAAQ,EACR,MAAM,EACN,iBAAiB,EACjB,MAAM,EACN,GAAG,IAAI,CACR,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAEvD,MAAM,cAAc,GAAG,UAA0C,CAAC;IAClE,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC;IAEnC,IAAI,GAAG,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,OAAO,aAAa,CAAC,SAAS,CAAC,MAAO,CAAC,MAAe,CAAM,CAAC;IAC/D,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,EAAE,CAAC,CAAC;AACjD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,77 @@
+import * as StellarSDK from '@stellar/stellar-sdk';
+export type ScVal = any;
+export declare enum ContractMethod {
+    Initialize = "initialize",
+    Execute = "execute",
+    CreateSession = "create_session",
+    ExecuteSession = "execute_session",
+    AddGuardians = "add_guardians",
+    Recover = "recover",
+    GetOwner = "get_owner",
+    GetGuardians = "get_guardians",
+    GetSession = "get_session"
+}
+interface BaseConfig {
+    rpcUrl: string;
+    networkPassphrase: string;
+}
+export interface WalletConfig extends BaseConfig {
+    contractId: string;
+}
+export interface FactoryConfig extends BaseConfig {
+    wasmHash: string;
+}
+export interface Session {
+    key: string;
+    limit: string;
+    spent: string;
+    expires_at: number;
+}
+export interface SorobanRpcServer {
+    getAccount(address: string): Promise<StellarSDK.Account>;
+    prepareTransaction(tx: StellarSDK.Transaction): Promise<StellarSDK.Transaction>;
+    sendTransaction(tx: StellarSDK.Transaction): Promise<SendTransactionResponse>;
+    getTransaction(hash: string): Promise<GetTransactionResponse>;
+    simulateTransaction(tx: StellarSDK.Transaction): Promise<SimulateTransactionResponse>;
+    readonly serverURL: URL;
+}
+export interface SendTransactionResponse {
+    status: 'PENDING' | 'ERROR' | 'DUPLICATE';
+    hash: string;
+    errorResultXdr?: string;
+}
+export interface GetTransactionResponse {
+    status: TransactionStatus;
+    resultXdr?: string;
+    returnValue?: unknown;
+}
+export declare enum TransactionStatus {
+    SUCCESS = "SUCCESS",
+    FAILED = "FAILED",
+    NOT_FOUND = "NOT_FOUND"
+}
+export interface SimulateTransactionResponse {
+    result?: {
+        retval: unknown;
+    };
+    error?: string;
+}
+export interface StellarApi {
+    isSimulationSuccess(response: SimulateTransactionResponse): boolean;
+    GetTransactionStatus: typeof TransactionStatus;
+}
+export interface StellarRpc {
+    Server: new (url: string) => SorobanRpcServer;
+    Api: StellarApi;
+    assembleTransaction: (tx: StellarSDK.Transaction, simulation: any) => StellarSDK.Transaction;
+}
+export interface StellarSDKWithRpc {
+    rpc: StellarRpc;
+    Account: typeof StellarSDK.Account;
+    scValToNative: (val: ScVal) => unknown;
+    nativeToScVal: (val: unknown, opts?: {
+        type?: string;
+    }) => ScVal;
+}
+export {};
+//# 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,UAAU,MAAM,sBAAsB,CAAC;AAKnD,MAAM,MAAM,KAAK,GAAG,GAAG,CAAC;AAGxB,oBAAY,cAAc;IACxB,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,aAAa,mBAAmB;IAChC,cAAc,oBAAoB;IAClC,YAAY,kBAAkB;IAC9B,OAAO,YAAY;IACnB,QAAQ,cAAc;IACtB,YAAY,kBAAkB;IAC9B,UAAU,gBAAgB;CAC3B;AAGD,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACzD,kBAAkB,CAAC,EAAE,EAAE,UAAU,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAChF,eAAe,CAAC,EAAE,EAAE,UAAU,CAAC,WAAW,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC9E,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC9D,mBAAmB,CAAC,EAAE,EAAE,UAAU,CAAC,WAAW,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACtF,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,oBAAY,iBAAiB;IAC3B,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE;QACP,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,UAAU;IACzB,mBAAmB,CAAC,QAAQ,EAAE,2BAA2B,GAAG,OAAO,CAAC;IACpE,oBAAoB,EAAE,OAAO,iBAAiB,CAAC;CAChD;AAGD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,gBAAgB,CAAC;IAC9C,GAAG,EAAE,UAAU,CAAC;IAEhB,mBAAmB,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,KAAK,UAAU,CAAC,WAAW,CAAC;CAC9F;AAGD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,UAAU,CAAC;IAChB,OAAO,EAAE,OAAO,UAAU,CAAC,OAAO,CAAC;IACnC,aAAa,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,OAAO,CAAC;IACvC,aAAa,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,KAAK,CAAC;CAClE"}

package/dist/types.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionStatus = exports.ContractMethod = void 0;
+// Smart Wallet contract interface
+var ContractMethod;
+(function (ContractMethod) {
+    ContractMethod["Initialize"] = "initialize";
+    ContractMethod["Execute"] = "execute";
+    ContractMethod["CreateSession"] = "create_session";
+    ContractMethod["ExecuteSession"] = "execute_session";
+    ContractMethod["AddGuardians"] = "add_guardians";
+    ContractMethod["Recover"] = "recover";
+    ContractMethod["GetOwner"] = "get_owner";
+    ContractMethod["GetGuardians"] = "get_guardians";
+    ContractMethod["GetSession"] = "get_session";
+})(ContractMethod || (exports.ContractMethod = ContractMethod = {}));
+var TransactionStatus;
+(function (TransactionStatus) {
+    TransactionStatus["SUCCESS"] = "SUCCESS";
+    TransactionStatus["FAILED"] = "FAILED";
+    TransactionStatus["NOT_FOUND"] = "NOT_FOUND";
+})(TransactionStatus || (exports.TransactionStatus = TransactionStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAOA,kCAAkC;AAClC,IAAY,cAUX;AAVD,WAAY,cAAc;IACxB,2CAAyB,CAAA;IACzB,qCAAmB,CAAA;IACnB,kDAAgC,CAAA;IAChC,oDAAkC,CAAA;IAClC,gDAA8B,CAAA;IAC9B,qCAAmB,CAAA;IACnB,wCAAsB,CAAA;IACtB,gDAA8B,CAAA;IAC9B,4CAA0B,CAAA;AAC5B,CAAC,EAVW,cAAc,8BAAd,cAAc,QAUzB;AA8CD,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC3B,wCAAmB,CAAA;IACnB,sCAAiB,CAAA;IACjB,4CAAuB,CAAA;AACzB,CAAC,EAJW,iBAAiB,iCAAjB,iBAAiB,QAI5B"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "stellar-aa-sdk",
+  "version": "0.1.0",
+  "description": "Account Abstraction SDK for Stellar/Soroban - Session keys, social recovery, and smart contract wallets",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "stellar",
+    "soroban",
+    "account-abstraction",
+    "session-keys",
+    "social-recovery",
+    "smart-wallets",
+    "web3",
+    "blockchain"
+  ],
+  "author": "0xaplus",
+  "license": "MIT",
+  "type": "commonjs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/payfrom/stellar-aa-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/payfrom/stellar-aa-sdk/issues"
+  },
+  "homepage": "https://github.com/payfrom/stellar-aa-sdk#readme",
+  "dependencies": {
+    "@stellar/stellar-sdk": "^14.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3"
+  }
+}