stellar-contracts-kit 0.1.0

package/dist/wallets/index.cjs

@@ -0,0 +1,199 @@
+'use strict';
+
+var freighter = require('@stellar/freighter-api');
+var signerExtensionApi = require('@lobstrco/signer-extension-api');
+var sdk = require('@cyphras/sdk');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var freighter__default = /*#__PURE__*/_interopDefault(freighter);
+
+// src/wallets/freighter.ts
+
+// src/errors/index.ts
+var StellarContractError = class extends Error {
+  constructor(code, message, cause) {
+    super(message);
+    this.name = "StellarContractError";
+    this.code = code;
+    this.cause = cause;
+  }
+};
+function makeError(code, message, cause) {
+  return new StellarContractError(code, message, cause);
+}
+
+// src/wallets/freighter.ts
+var FreighterAdapter = class {
+  constructor() {
+    this.name = "Freighter";
+    this.installUrl = "https://freighter.app";
+  }
+  async isAvailable() {
+    const res = await freighter__default.default.isConnected();
+    return !res.error && res.isConnected === true;
+  }
+  async connect() {
+    const res = await freighter__default.default.requestAccess();
+    if (res.error) {
+      throw makeError("WALLET_REJECTED", res.error.message ?? "Freighter access denied");
+    }
+    return { address: res.address };
+  }
+  async disconnect() {
+  }
+  async getAddress() {
+    const res = await freighter__default.default.getAddress();
+    if (res.error) {
+      throw makeError("WALLET_NOT_CONNECTED", res.error.message ?? "Could not get Freighter address");
+    }
+    return res.address;
+  }
+  async getNetworkPassphrase() {
+    const res = await freighter__default.default.getNetwork();
+    if (res.error) {
+      throw makeError("RPC_ERROR", res.error.message ?? "Could not get Freighter network");
+    }
+    return res.networkPassphrase;
+  }
+  async signTransaction(xdr, opts) {
+    const signOpts = {
+      networkPassphrase: opts.networkPassphrase
+    };
+    if (opts.address !== void 0) signOpts.address = opts.address;
+    const res = await freighter__default.default.signTransaction(xdr, signOpts);
+    if (res.error) {
+      throw makeError("WALLET_REJECTED", res.error.message ?? "Freighter rejected transaction signing");
+    }
+    return res.signedTxXdr;
+  }
+  async signAuthEntry(entryXdr, opts) {
+    const signOpts = {
+      networkPassphrase: opts.networkPassphrase
+    };
+    if (opts.address !== void 0) signOpts.address = opts.address;
+    const res = await freighter__default.default.signAuthEntry(entryXdr, signOpts);
+    if (res.error) {
+      throw makeError("WALLET_REJECTED", res.error.message ?? "Freighter rejected auth entry signing");
+    }
+    if (!res.signedAuthEntry) {
+      throw makeError("WALLET_REJECTED", "Freighter returned null auth entry");
+    }
+    return res.signedAuthEntry;
+  }
+};
+var LobstrAdapter = class {
+  constructor() {
+    this.name = "Lobstr";
+    this.installUrl = "https://lobstr.co/";
+  }
+  async isAvailable() {
+    if (typeof window === "undefined") return false;
+    if (window.lobstrSignerExtension) return true;
+    return Promise.race([
+      signerExtensionApi.isConnected(),
+      new Promise((res) => setTimeout(() => res(false), 500))
+    ]);
+  }
+  async connect() {
+    try {
+      const address = await signerExtensionApi.getPublicKey();
+      return { address };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (msg.toLowerCase().includes("reject") || msg.toLowerCase().includes("denied") || msg.toLowerCase().includes("cancel")) {
+        throw makeError("WALLET_REJECTED", "Lobstr connection was rejected by the user");
+      }
+      throw makeError("WALLET_REJECTED", `Lobstr connection failed: ${msg}`, err);
+    }
+  }
+  async disconnect() {
+  }
+  async getAddress() {
+    try {
+      return await signerExtensionApi.getPublicKey();
+    } catch (err) {
+      throw makeError("WALLET_NOT_CONNECTED", "Could not retrieve Lobstr public key. Make sure the wallet is connected.", err);
+    }
+  }
+  async getNetworkPassphrase() {
+    throw makeError(
+      "RPC_ERROR",
+      "Lobstr does not expose network info. Ensure your Lobstr extension is set to the same network as your kit config."
+    );
+  }
+  async signTransaction(xdr, _opts) {
+    try {
+      return await signerExtensionApi.signTransaction(xdr);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (msg.toLowerCase().includes("reject") || msg.toLowerCase().includes("denied") || msg.toLowerCase().includes("cancel")) {
+        throw makeError("WALLET_REJECTED", "Lobstr rejected transaction signing");
+      }
+      throw makeError("WALLET_REJECTED", `Lobstr signing failed: ${msg}`, err);
+    }
+  }
+  async signAuthEntry(_entryXdr, _opts) {
+    throw makeError(
+      "WALLET_REJECTED",
+      "Lobstr does not support signing individual auth entries. For multi-party auth contracts, use Freighter."
+    );
+  }
+};
+function toKitError(err) {
+  const c = err.code;
+  const m = err.message;
+  if (c === "REJECTED" || c === "USER_REJECTED") throw makeError("WALLET_REJECTED", m);
+  if (c === "TIMEOUT") throw makeError("TX_TIMEOUT", m);
+  if (c === "NETWORK_MISMATCH") throw makeError("WALLET_NETWORK_MISMATCH", m);
+  if (c === "UNAUTHORIZED" || c === "NOT_ALLOWED" || c === "NOT_CONNECTED" || c === "WALLET_LOCKED") {
+    throw makeError("WALLET_NOT_CONNECTED", m);
+  }
+  throw makeError("RPC_ERROR", m);
+}
+var CyphrasAdapter = class {
+  constructor() {
+    this.name = "Cyphras";
+    this.installUrl = "https://cyphras.com";
+  }
+  isAvailable() {
+    return sdk.isExtensionInstalled();
+  }
+  async connect() {
+    if (!sdk.isExtensionInstalled()) throw makeError("WALLET_NOT_FOUND", "Cyphras extension is not installed");
+    const res = await sdk.cyphras.stellar.connect();
+    if (res.error) toKitError(res.error);
+    return { address: res.address };
+  }
+  async disconnect() {
+    if (!sdk.isExtensionInstalled()) return;
+    await sdk.cyphras.stellar.disconnect();
+  }
+  async getAddress() {
+    const res = await sdk.cyphras.stellar.getAccount();
+    if (res.error) toKitError(res.error);
+    return res.address;
+  }
+  async getNetworkPassphrase() {
+    const res = await sdk.cyphras.stellar.getNetwork();
+    if (res.error) toKitError(res.error);
+    return res.networkPassphrase;
+  }
+  async signTransaction(xdr, _opts) {
+    const res = await sdk.cyphras.stellar.sign(xdr);
+    if (res.error) toKitError(res.error);
+    return res.signedTxXdr;
+  }
+  async signAuthEntry(entryXdr, opts) {
+    const res = await sdk.cyphras.stellar.sign(entryXdr, {
+      type: "authEntry",
+      networkPassphrase: opts.networkPassphrase
+    });
+    if (res.error) toKitError(res.error);
+    return res.signedAuthEntry;
+  }
+};
+
+exports.CyphrasAdapter = CyphrasAdapter;
+exports.FreighterAdapter = FreighterAdapter;
+exports.LobstrAdapter = LobstrAdapter;

package/dist/wallets/index.d.cts

@@ -0,0 +1,60 @@
+interface ConnectResult {
+    address: string;
+}
+interface SignTransactionOpts {
+    networkPassphrase: string;
+    address?: string;
+}
+interface SignAuthEntryOpts {
+    networkPassphrase: string;
+    address?: string;
+}
+interface WalletAdapter {
+    readonly name: string;
+    readonly installUrl: string;
+    isAvailable(): boolean | Promise<boolean>;
+    connect(): Promise<ConnectResult>;
+    disconnect(): Promise<void>;
+    getAddress(): Promise<string>;
+    getNetworkPassphrase(): Promise<string>;
+    signTransaction(xdr: string, opts: SignTransactionOpts): Promise<string>;
+    signAuthEntry(entryXdr: string, opts: SignAuthEntryOpts): Promise<string>;
+}
+
+declare class FreighterAdapter implements WalletAdapter {
+    readonly name = "Freighter";
+    readonly installUrl = "https://freighter.app";
+    isAvailable(): Promise<boolean>;
+    connect(): Promise<ConnectResult>;
+    disconnect(): Promise<void>;
+    getAddress(): Promise<string>;
+    getNetworkPassphrase(): Promise<string>;
+    signTransaction(xdr: string, opts: SignTransactionOpts): Promise<string>;
+    signAuthEntry(entryXdr: string, opts: SignAuthEntryOpts): Promise<string>;
+}
+
+declare class LobstrAdapter implements WalletAdapter {
+    readonly name = "Lobstr";
+    readonly installUrl = "https://lobstr.co/";
+    isAvailable(): Promise<boolean>;
+    connect(): Promise<ConnectResult>;
+    disconnect(): Promise<void>;
+    getAddress(): Promise<string>;
+    getNetworkPassphrase(): Promise<string>;
+    signTransaction(xdr: string, _opts: SignTransactionOpts): Promise<string>;
+    signAuthEntry(_entryXdr: string, _opts: SignAuthEntryOpts): Promise<string>;
+}
+
+declare class CyphrasAdapter implements WalletAdapter {
+    readonly name = "Cyphras";
+    readonly installUrl = "https://cyphras.com";
+    isAvailable(): boolean;
+    connect(): Promise<ConnectResult>;
+    disconnect(): Promise<void>;
+    getAddress(): Promise<string>;
+    getNetworkPassphrase(): Promise<string>;
+    signTransaction(xdr: string, _opts: SignTransactionOpts): Promise<string>;
+    signAuthEntry(entryXdr: string, opts: SignAuthEntryOpts): Promise<string>;
+}
+
+export { type ConnectResult, CyphrasAdapter, FreighterAdapter, LobstrAdapter, type SignAuthEntryOpts, type SignTransactionOpts, type WalletAdapter };

package/dist/wallets/index.d.ts

@@ -0,0 +1,60 @@
+interface ConnectResult {
+    address: string;
+}
+interface SignTransactionOpts {
+    networkPassphrase: string;
+    address?: string;
+}
+interface SignAuthEntryOpts {
+    networkPassphrase: string;
+    address?: string;
+}
+interface WalletAdapter {
+    readonly name: string;
+    readonly installUrl: string;
+    isAvailable(): boolean | Promise<boolean>;
+    connect(): Promise<ConnectResult>;
+    disconnect(): Promise<void>;
+    getAddress(): Promise<string>;
+    getNetworkPassphrase(): Promise<string>;
+    signTransaction(xdr: string, opts: SignTransactionOpts): Promise<string>;
+    signAuthEntry(entryXdr: string, opts: SignAuthEntryOpts): Promise<string>;
+}
+
+declare class FreighterAdapter implements WalletAdapter {
+    readonly name = "Freighter";
+    readonly installUrl = "https://freighter.app";
+    isAvailable(): Promise<boolean>;
+    connect(): Promise<ConnectResult>;
+    disconnect(): Promise<void>;
+    getAddress(): Promise<string>;
+    getNetworkPassphrase(): Promise<string>;
+    signTransaction(xdr: string, opts: SignTransactionOpts): Promise<string>;
+    signAuthEntry(entryXdr: string, opts: SignAuthEntryOpts): Promise<string>;
+}
+
+declare class LobstrAdapter implements WalletAdapter {
+    readonly name = "Lobstr";
+    readonly installUrl = "https://lobstr.co/";
+    isAvailable(): Promise<boolean>;
+    connect(): Promise<ConnectResult>;
+    disconnect(): Promise<void>;
+    getAddress(): Promise<string>;
+    getNetworkPassphrase(): Promise<string>;
+    signTransaction(xdr: string, _opts: SignTransactionOpts): Promise<string>;
+    signAuthEntry(_entryXdr: string, _opts: SignAuthEntryOpts): Promise<string>;
+}
+
+declare class CyphrasAdapter implements WalletAdapter {
+    readonly name = "Cyphras";
+    readonly installUrl = "https://cyphras.com";
+    isAvailable(): boolean;
+    connect(): Promise<ConnectResult>;
+    disconnect(): Promise<void>;
+    getAddress(): Promise<string>;
+    getNetworkPassphrase(): Promise<string>;
+    signTransaction(xdr: string, _opts: SignTransactionOpts): Promise<string>;
+    signAuthEntry(entryXdr: string, opts: SignAuthEntryOpts): Promise<string>;
+}
+
+export { type ConnectResult, CyphrasAdapter, FreighterAdapter, LobstrAdapter, type SignAuthEntryOpts, type SignTransactionOpts, type WalletAdapter };

package/dist/wallets/index.js

@@ -0,0 +1,191 @@
+import freighter from '@stellar/freighter-api';
+import { isConnected, getPublicKey, signTransaction } from '@lobstrco/signer-extension-api';
+import { isExtensionInstalled, cyphras } from '@cyphras/sdk';
+
+// src/wallets/freighter.ts
+
+// src/errors/index.ts
+var StellarContractError = class extends Error {
+  constructor(code, message, cause) {
+    super(message);
+    this.name = "StellarContractError";
+    this.code = code;
+    this.cause = cause;
+  }
+};
+function makeError(code, message, cause) {
+  return new StellarContractError(code, message, cause);
+}
+
+// src/wallets/freighter.ts
+var FreighterAdapter = class {
+  constructor() {
+    this.name = "Freighter";
+    this.installUrl = "https://freighter.app";
+  }
+  async isAvailable() {
+    const res = await freighter.isConnected();
+    return !res.error && res.isConnected === true;
+  }
+  async connect() {
+    const res = await freighter.requestAccess();
+    if (res.error) {
+      throw makeError("WALLET_REJECTED", res.error.message ?? "Freighter access denied");
+    }
+    return { address: res.address };
+  }
+  async disconnect() {
+  }
+  async getAddress() {
+    const res = await freighter.getAddress();
+    if (res.error) {
+      throw makeError("WALLET_NOT_CONNECTED", res.error.message ?? "Could not get Freighter address");
+    }
+    return res.address;
+  }
+  async getNetworkPassphrase() {
+    const res = await freighter.getNetwork();
+    if (res.error) {
+      throw makeError("RPC_ERROR", res.error.message ?? "Could not get Freighter network");
+    }
+    return res.networkPassphrase;
+  }
+  async signTransaction(xdr, opts) {
+    const signOpts = {
+      networkPassphrase: opts.networkPassphrase
+    };
+    if (opts.address !== void 0) signOpts.address = opts.address;
+    const res = await freighter.signTransaction(xdr, signOpts);
+    if (res.error) {
+      throw makeError("WALLET_REJECTED", res.error.message ?? "Freighter rejected transaction signing");
+    }
+    return res.signedTxXdr;
+  }
+  async signAuthEntry(entryXdr, opts) {
+    const signOpts = {
+      networkPassphrase: opts.networkPassphrase
+    };
+    if (opts.address !== void 0) signOpts.address = opts.address;
+    const res = await freighter.signAuthEntry(entryXdr, signOpts);
+    if (res.error) {
+      throw makeError("WALLET_REJECTED", res.error.message ?? "Freighter rejected auth entry signing");
+    }
+    if (!res.signedAuthEntry) {
+      throw makeError("WALLET_REJECTED", "Freighter returned null auth entry");
+    }
+    return res.signedAuthEntry;
+  }
+};
+var LobstrAdapter = class {
+  constructor() {
+    this.name = "Lobstr";
+    this.installUrl = "https://lobstr.co/";
+  }
+  async isAvailable() {
+    if (typeof window === "undefined") return false;
+    if (window.lobstrSignerExtension) return true;
+    return Promise.race([
+      isConnected(),
+      new Promise((res) => setTimeout(() => res(false), 500))
+    ]);
+  }
+  async connect() {
+    try {
+      const address = await getPublicKey();
+      return { address };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (msg.toLowerCase().includes("reject") || msg.toLowerCase().includes("denied") || msg.toLowerCase().includes("cancel")) {
+        throw makeError("WALLET_REJECTED", "Lobstr connection was rejected by the user");
+      }
+      throw makeError("WALLET_REJECTED", `Lobstr connection failed: ${msg}`, err);
+    }
+  }
+  async disconnect() {
+  }
+  async getAddress() {
+    try {
+      return await getPublicKey();
+    } catch (err) {
+      throw makeError("WALLET_NOT_CONNECTED", "Could not retrieve Lobstr public key. Make sure the wallet is connected.", err);
+    }
+  }
+  async getNetworkPassphrase() {
+    throw makeError(
+      "RPC_ERROR",
+      "Lobstr does not expose network info. Ensure your Lobstr extension is set to the same network as your kit config."
+    );
+  }
+  async signTransaction(xdr, _opts) {
+    try {
+      return await signTransaction(xdr);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (msg.toLowerCase().includes("reject") || msg.toLowerCase().includes("denied") || msg.toLowerCase().includes("cancel")) {
+        throw makeError("WALLET_REJECTED", "Lobstr rejected transaction signing");
+      }
+      throw makeError("WALLET_REJECTED", `Lobstr signing failed: ${msg}`, err);
+    }
+  }
+  async signAuthEntry(_entryXdr, _opts) {
+    throw makeError(
+      "WALLET_REJECTED",
+      "Lobstr does not support signing individual auth entries. For multi-party auth contracts, use Freighter."
+    );
+  }
+};
+function toKitError(err) {
+  const c = err.code;
+  const m = err.message;
+  if (c === "REJECTED" || c === "USER_REJECTED") throw makeError("WALLET_REJECTED", m);
+  if (c === "TIMEOUT") throw makeError("TX_TIMEOUT", m);
+  if (c === "NETWORK_MISMATCH") throw makeError("WALLET_NETWORK_MISMATCH", m);
+  if (c === "UNAUTHORIZED" || c === "NOT_ALLOWED" || c === "NOT_CONNECTED" || c === "WALLET_LOCKED") {
+    throw makeError("WALLET_NOT_CONNECTED", m);
+  }
+  throw makeError("RPC_ERROR", m);
+}
+var CyphrasAdapter = class {
+  constructor() {
+    this.name = "Cyphras";
+    this.installUrl = "https://cyphras.com";
+  }
+  isAvailable() {
+    return isExtensionInstalled();
+  }
+  async connect() {
+    if (!isExtensionInstalled()) throw makeError("WALLET_NOT_FOUND", "Cyphras extension is not installed");
+    const res = await cyphras.stellar.connect();
+    if (res.error) toKitError(res.error);
+    return { address: res.address };
+  }
+  async disconnect() {
+    if (!isExtensionInstalled()) return;
+    await cyphras.stellar.disconnect();
+  }
+  async getAddress() {
+    const res = await cyphras.stellar.getAccount();
+    if (res.error) toKitError(res.error);
+    return res.address;
+  }
+  async getNetworkPassphrase() {
+    const res = await cyphras.stellar.getNetwork();
+    if (res.error) toKitError(res.error);
+    return res.networkPassphrase;
+  }
+  async signTransaction(xdr, _opts) {
+    const res = await cyphras.stellar.sign(xdr);
+    if (res.error) toKitError(res.error);
+    return res.signedTxXdr;
+  }
+  async signAuthEntry(entryXdr, opts) {
+    const res = await cyphras.stellar.sign(entryXdr, {
+      type: "authEntry",
+      networkPassphrase: opts.networkPassphrase
+    });
+    if (res.error) toKitError(res.error);
+    return res.signedAuthEntry;
+  }
+};
+
+export { CyphrasAdapter, FreighterAdapter, LobstrAdapter };

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "stellar-contracts-kit",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for Soroban smart contract interactions on Stellar",
+  "author": "fxjrin",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fxjrin/stellar-contracts-kit.git"
+  },
+  "keywords": [
+    "stellar",
+    "soroban",
+    "smart-contract",
+    "blockchain",
+    "typescript",
+    "sdk",
+    "cli",
+    "type-generator",
+    "wallet",
+    "dapp",
+    "freighter",
+    "lobstr",
+    "cyphras",
+    "web3"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./wallets": {
+      "types": "./dist/wallets/index.d.ts",
+      "import": "./dist/wallets/index.js",
+      "require": "./dist/wallets/index.cjs"
+    }
+  },
+  "bin": {
+    "stellar-contracts-kit": "./dist/cli/generate.js",
+    "sck": "./dist/cli/generate.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@cyphras/sdk": "^0.1.0",
+    "@lobstrco/signer-extension-api": "^2.0.0",
+    "@stellar/freighter-api": "^6.0.0",
+    "@stellar/stellar-sdk": "^15.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.3",
+    "vitest": "^4.1.7"
+  }
+}