@orbi-wallet/sdk 0.1.3 → 0.2.0

package/dist/client.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * @orbi-wallet/sdk — Orbi Smart Wallet SDK (G-wallet)
  *
@@ -9,17 +8,15 @@
  *   const { walletAddress } = await orbi.connect();
  *   const { signedXdr } = await orbi.signTransaction({ xdr });
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OrbiClient = void 0;
 // Generated from package.json at build time (see scripts/generate-version.js)
 // — package.json stays the single source of truth for name/version.
-const version_1 = require("./version");
+import { SDK_NAME, SDK_VERSION } from './version';
 const KEYS_URL = 'https://keys.orbiwallet.xyz';
 const KEYS_ORIGIN = new URL(KEYS_URL).origin;
 const SESSION_KEY = 'orbi_session';
 const POPUP_WIDTH = 420;
 const POPUP_HEIGHT = 640;
-class OrbiClient {
+export class OrbiClient {
     constructor(config = {}) {
         this.network = config.network ?? 'testnet';
         this.chain = config.chain ?? 'stellar';
@@ -191,8 +188,8 @@ class OrbiClient {
         }
         const url = new URL(`${KEYS_URL}${req.path}`);
         url.searchParams.set('origin', window.location.origin);
-        url.searchParams.set('sdkName', version_1.SDK_NAME);
-        url.searchParams.set('sdkVersion', version_1.SDK_VERSION);
+        url.searchParams.set('sdkName', SDK_NAME);
+        url.searchParams.set('sdkVersion', SDK_VERSION);
         for (const [key, value] of Object.entries(req.params ?? {}))
             url.searchParams.set(key, value);
         const left = window.screenX + Math.max(0, (window.outerWidth - POPUP_WIDTH) / 2);
@@ -237,4 +234,3 @@ class OrbiClient {
         });
     }
 }
-exports.OrbiClient = OrbiClient;

package/dist/index.d.ts

@@ -1,2 +1,4 @@
 export { OrbiClient } from './client';
+export { OrbiEIP1193Provider, createOrbiProvider } from './provider';
+export type { OrbiProviderChain, OrbiProviderConfig } from './provider';
 export type { ConnectedWallet, EvmSignatureResult, EvmSignResult, EvmTxParams, OrbiChain, OrbiClientConfig, OrbiNetwork, SignResult } from './types';

package/dist/index.js

@@ -1,5 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OrbiClient = void 0;
-var client_1 = require("./client");
-Object.defineProperty(exports, "OrbiClient", { enumerable: true, get: function () { return client_1.OrbiClient; } });
+export { OrbiClient } from './client';
+export { OrbiEIP1193Provider, createOrbiProvider } from './provider';

package/dist/provider.d.ts

@@ -0,0 +1,47 @@
+/**
+ * EIP-1193 provider for Orbi (EVM).
+ *
+ * Wraps OrbiClient so any standard EVM tooling — wagmi, ethers, viem,
+ * RainbowKit — can talk to an Orbi passkey wallet through the universal
+ * `request({ method, params })` interface. Signing methods open the Orbi popup
+ * (where the passkey lives); read methods are proxied to the chain's RPC.
+ */
+import { OrbiClient } from './client';
+import type { OrbiNetwork } from './types';
+export interface OrbiProviderChain {
+    chainId: number;
+    rpcUrl: string;
+}
+export interface OrbiProviderConfig {
+    /** EVM chains this provider can serve, each with a JSON-RPC URL. */
+    chains: OrbiProviderChain[];
+    /** Active chain on construction. Defaults to the first chain. */
+    defaultChainId?: number;
+    network?: OrbiNetwork;
+    /** Reuse an existing client (and its session); one is created otherwise. */
+    client?: OrbiClient;
+}
+interface RequestArgs {
+    method: string;
+    params?: unknown[] | Record<string, unknown>;
+}
+type Listener = (...args: unknown[]) => void;
+export declare class OrbiEIP1193Provider {
+    /** Lets dApps detect Orbi specifically (à la `isMetaMask`). */
+    readonly isOrbi = true;
+    private client;
+    private chains;
+    private chainId;
+    private listeners;
+    constructor(config: OrbiProviderConfig);
+    on(event: string, fn: Listener): this;
+    removeListener(event: string, fn: Listener): this;
+    private emit;
+    private currentAccounts;
+    request(args: RequestArgs): Promise<unknown>;
+    private rpc;
+    /** Convenience: forget the cached session (next eth_requestAccounts re-prompts). */
+    disconnect(): void;
+}
+export declare function createOrbiProvider(config: OrbiProviderConfig): OrbiEIP1193Provider;
+export {};

package/dist/provider.js

@@ -0,0 +1,161 @@
+/**
+ * EIP-1193 provider for Orbi (EVM).
+ *
+ * Wraps OrbiClient so any standard EVM tooling — wagmi, ethers, viem,
+ * RainbowKit — can talk to an Orbi passkey wallet through the universal
+ * `request({ method, params })` interface. Signing methods open the Orbi popup
+ * (where the passkey lives); read methods are proxied to the chain's RPC.
+ */
+import { OrbiClient } from './client';
+function providerError(code, message) {
+    return Object.assign(new Error(message), { code });
+}
+// SDK popup rejections → EIP-1193's standard "user rejected" code (4001).
+function mapRejection(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (/cancel|closed|reject/i.test(msg))
+        throw providerError(4001, 'User rejected the request');
+    throw err;
+}
+const isAddress = (v) => typeof v === 'string' && /^0x[0-9a-fA-F]{40}$/.test(v);
+const toHexNum = (n) => '0x' + n.toString(16);
+export class OrbiEIP1193Provider {
+    constructor(config) {
+        /** Lets dApps detect Orbi specifically (à la `isMetaMask`). */
+        this.isOrbi = true;
+        this.listeners = {};
+        if (!config.chains?.length)
+            throw new Error('OrbiProvider requires at least one chain');
+        this.chains = new Map(config.chains.map((c) => [c.chainId, c.rpcUrl]));
+        this.chainId = config.defaultChainId ?? config.chains[0].chainId;
+        if (!this.chains.has(this.chainId))
+            throw new Error(`No RPC configured for chain ${this.chainId}`);
+        this.client =
+            config.client ?? new OrbiClient({ network: config.network, chain: 'botchain', chainId: this.chainId });
+    }
+    // ── EIP-1193 events ──────────────────────────────────────────────────────────
+    on(event, fn) { (this.listeners[event] ??= []).push(fn); return this; }
+    removeListener(event, fn) {
+        this.listeners[event] = (this.listeners[event] ?? []).filter((l) => l !== fn);
+        return this;
+    }
+    emit(event, ...args) {
+        (this.listeners[event] ?? []).forEach((l) => l(...args));
+    }
+    currentAccounts() {
+        const addr = this.client.getAddress();
+        return addr && this.client.getChain() === 'botchain' ? [addr] : [];
+    }
+    // ── EIP-1193 request ─────────────────────────────────────────────────────────
+    async request(args) {
+        const { method } = args;
+        const params = (Array.isArray(args.params) ? args.params : []);
+        switch (method) {
+            case 'eth_requestAccounts': {
+                try {
+                    const { walletAddress } = await this.client.connect({ chain: 'botchain' });
+                    this.emit('connect', { chainId: toHexNum(this.chainId) });
+                    this.emit('accountsChanged', [walletAddress]);
+                    return [walletAddress];
+                }
+                catch (err) {
+                    return mapRejection(err);
+                }
+            }
+            case 'eth_accounts':
+                return this.currentAccounts();
+            case 'eth_chainId':
+                return toHexNum(this.chainId);
+            case 'net_version':
+                return String(this.chainId);
+            case 'wallet_getPermissions':
+            case 'wallet_requestPermissions':
+                return [{ parentCapability: 'eth_accounts' }];
+            case 'wallet_switchEthereumChain': {
+                const target = parseInt(params[0]?.chainId, 16);
+                if (!this.chains.has(target)) {
+                    throw providerError(4902, `Chain ${target} not configured in Orbi provider`);
+                }
+                this.chainId = target;
+                this.emit('chainChanged', toHexNum(target));
+                return null;
+            }
+            case 'wallet_addEthereumChain': {
+                const target = parseInt(params[0]?.chainId, 16);
+                if (!this.chains.has(target))
+                    throw providerError(4902, `Chain ${target} not supported by Orbi`);
+                return null;
+            }
+            case 'eth_sendTransaction': {
+                const tx = (params[0] ?? {});
+                try {
+                    const { txHash } = await this.client.signEvmTransaction({
+                        to: tx.to,
+                        value: tx.value ? BigInt(tx.value).toString() : undefined,
+                        data: tx.data,
+                        gas: tx.gas ? BigInt(tx.gas).toString() : undefined,
+                        chainId: this.chainId,
+                    });
+                    return txHash;
+                }
+                catch (err) {
+                    return mapRejection(err);
+                }
+            }
+            case 'personal_sign': {
+                // params: [message, address] (order varies by dApp — detect the address)
+                const message = (isAddress(params[0]) ? params[1] : params[0]);
+                try {
+                    const { signature } = await this.client.signMessage({ message, chainId: this.chainId });
+                    return signature;
+                }
+                catch (err) {
+                    return mapRejection(err);
+                }
+            }
+            case 'eth_signTypedData_v4': {
+                // params: [address, typedData]
+                const raw = (isAddress(params[0]) ? params[1] : params[0]);
+                const typedData = typeof raw === 'string' ? JSON.parse(raw) : raw;
+                try {
+                    const { signature } = await this.client.signTypedData({ typedData, chainId: this.chainId });
+                    return signature;
+                }
+                catch (err) {
+                    return mapRejection(err);
+                }
+            }
+            case 'eth_sign':
+            case 'eth_signTypedData':
+            case 'eth_signTypedData_v3':
+                throw providerError(4200, `${method} is not supported — use personal_sign or eth_signTypedData_v4`);
+            // Everything else (eth_call, eth_getBalance, eth_estimateGas,
+            // eth_getTransactionReceipt, eth_blockNumber, …) is a read — proxy to RPC.
+            default:
+                return this.rpc(method, params);
+        }
+    }
+    async rpc(method, params) {
+        const url = this.chains.get(this.chainId);
+        if (!url)
+            throw providerError(4901, `No RPC for chain ${this.chainId}`);
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ jsonrpc: '2.0', id: Date.now(), method, params }),
+        });
+        const json = (await res.json());
+        if (json.error)
+            throw providerError(json.error.code ?? -32000, json.error.message ?? 'RPC error');
+        return json.result;
+    }
+    /** Convenience: forget the cached session (next eth_requestAccounts re-prompts). */
+    disconnect() {
+        this.client.disconnect();
+        this.emit('disconnect');
+        this.emit('accountsChanged', []);
+    }
+}
+export function createOrbiProvider(config) {
+    return new OrbiEIP1193Provider(config);
+}

package/dist/rainbowkit.d.ts

@@ -0,0 +1,16 @@
+/**
+ * RainbowKit wallet for Orbi (Layer D).
+ *
+ * Drop Orbi into any RainbowKit dApp's wallet list:
+ *
+ *   import { orbiWallet } from '@orbi-wallet/sdk/rainbowkit';
+ *   const connectors = connectorsForWallets(
+ *     [{ groupName: 'Recommended', wallets: [orbiWallet()] }],
+ *     { appName, projectId },
+ *   );
+ *
+ * Requires `wagmi`, `viem`, and `@rainbow-me/rainbowkit` as peer dependencies.
+ */
+import type { Wallet } from '@rainbow-me/rainbowkit';
+import { type OrbiConnectorParams } from './wagmi';
+export declare function orbiWallet(params?: OrbiConnectorParams): Wallet;

package/dist/rainbowkit.js

@@ -0,0 +1,30 @@
+/**
+ * RainbowKit wallet for Orbi (Layer D).
+ *
+ * Drop Orbi into any RainbowKit dApp's wallet list:
+ *
+ *   import { orbiWallet } from '@orbi-wallet/sdk/rainbowkit';
+ *   const connectors = connectorsForWallets(
+ *     [{ groupName: 'Recommended', wallets: [orbiWallet()] }],
+ *     { appName, projectId },
+ *   );
+ *
+ * Requires `wagmi`, `viem`, and `@rainbow-me/rainbowkit` as peer dependencies.
+ */
+import { createConnector } from 'wagmi';
+import { orbiConnectorImpl } from './wagmi';
+const ICON_URL = 'https://keys.orbiwallet.xyz/Orbi%20Icon.png';
+export function orbiWallet(params = {}) {
+    return {
+        id: 'orbi',
+        name: 'Orbi',
+        iconUrl: ICON_URL,
+        iconBackground: '#020817',
+        // Passkey wallet — nothing to install; always available in-browser.
+        installed: true,
+        createConnector: (walletDetails) => createConnector((config) => ({
+            ...orbiConnectorImpl(params)(config),
+            ...walletDetails,
+        })),
+    };
+}

package/dist/types.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 export declare const SDK_NAME = "@orbi-wallet/sdk";
-export declare const SDK_VERSION = "0.1.3";
+export declare const SDK_VERSION = "0.2.0";

package/dist/version.js

@@ -1,6 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SDK_VERSION = exports.SDK_NAME = void 0;
 // Generated by scripts/generate-version.js from package.json — do not edit.
-exports.SDK_NAME = "@orbi-wallet/sdk";
-exports.SDK_VERSION = "0.1.3";
+export const SDK_NAME = "@orbi-wallet/sdk";
+export const SDK_VERSION = "0.2.0";

package/dist/wagmi.d.ts

@@ -0,0 +1,22 @@
+/**
+ * wagmi connector for Orbi (Layer C).
+ *
+ * Wraps the Orbi EIP-1193 provider as a wagmi v2 connector so Orbi can be used
+ * with the entire wagmi/viem ecosystem — `writeContract`, `readContract`,
+ * SIWE, chain switching — with no Orbi-specific code in the dApp. ABI encoding
+ * is handled by viem/wagmi; the encoded calldata flows to Orbi's popup via the
+ * provider's `eth_sendTransaction`.
+ *
+ * Requires `wagmi` and `viem` as peer dependencies (a wagmi dApp already has them).
+ */
+import { type CreateConnectorFn } from 'wagmi';
+import { type OrbiProviderChain } from './provider';
+import type { OrbiNetwork } from './types';
+export interface OrbiConnectorParams {
+    /** Explicit chainId→rpcUrl list. Defaults to the wagmi config's chains. */
+    chains?: OrbiProviderChain[];
+    network?: OrbiNetwork;
+}
+export declare function orbiConnectorImpl(params?: OrbiConnectorParams): CreateConnectorFn;
+/** Standalone wagmi connector (for dApps not using RainbowKit). */
+export declare function orbiConnector(params?: OrbiConnectorParams): CreateConnectorFn;

package/dist/wagmi.js

@@ -0,0 +1,97 @@
+/**
+ * wagmi connector for Orbi (Layer C).
+ *
+ * Wraps the Orbi EIP-1193 provider as a wagmi v2 connector so Orbi can be used
+ * with the entire wagmi/viem ecosystem — `writeContract`, `readContract`,
+ * SIWE, chain switching — with no Orbi-specific code in the dApp. ABI encoding
+ * is handled by viem/wagmi; the encoded calldata flows to Orbi's popup via the
+ * provider's `eth_sendTransaction`.
+ *
+ * Requires `wagmi` and `viem` as peer dependencies (a wagmi dApp already has them).
+ */
+import { createConnector } from 'wagmi';
+import { getAddress } from 'viem';
+import { OrbiEIP1193Provider } from './provider';
+// Inner factory: `(config) => connectorObject`. Exported separately because
+// RainbowKit composes it with its own wallet details (see rainbowkit.ts).
+export function orbiConnectorImpl(params = {}) {
+    return ((config) => {
+        let provider;
+        const getProvider = async () => {
+            if (!provider) {
+                const chains = params.chains ??
+                    config.chains.map((c) => ({ chainId: c.id, rpcUrl: c.rpcUrls.default.http[0] }));
+                provider = new OrbiEIP1193Provider({ chains, network: params.network });
+            }
+            return provider;
+        };
+        const getChainId = async () => {
+            const p = await getProvider();
+            return Number((await p.request({ method: 'eth_chainId' })));
+        };
+        const getAccounts = async () => {
+            const p = await getProvider();
+            const accounts = (await p.request({ method: 'eth_accounts' }));
+            return accounts.map((a) => getAddress(a));
+        };
+        const switchChain = async ({ chainId }) => {
+            const p = await getProvider();
+            await p.request({ method: 'wallet_switchEthereumChain', params: [{ chainId: `0x${chainId.toString(16)}` }] });
+            const chain = config.chains.find((c) => c.id === chainId);
+            if (!chain)
+                throw new Error(`Chain ${chainId} not configured`);
+            config.emitter.emit('change', { chainId });
+            return chain;
+        };
+        const onAccountsChanged = (accounts) => {
+            if (accounts.length === 0)
+                config.emitter.emit('disconnect');
+            else
+                config.emitter.emit('change', { accounts: accounts.map((a) => getAddress(a)) });
+        };
+        const onChainChanged = (chain) => config.emitter.emit('change', { chainId: Number(chain) });
+        const onDisconnect = () => config.emitter.emit('disconnect');
+        return {
+            id: 'orbi',
+            name: 'Orbi',
+            type: 'orbi',
+            async connect({ chainId } = {}) {
+                const p = await getProvider();
+                const accounts = (await p.request({ method: 'eth_requestAccounts' })).map((a) => getAddress(a));
+                p.on('accountsChanged', onAccountsChanged);
+                p.on('chainChanged', onChainChanged);
+                p.on('disconnect', onDisconnect);
+                let id = await getChainId();
+                if (chainId && chainId !== id)
+                    id = (await switchChain({ chainId })).id;
+                return { accounts, chainId: id };
+            },
+            async disconnect() {
+                const p = await getProvider();
+                p.removeListener('accountsChanged', onAccountsChanged);
+                p.removeListener('chainChanged', onChainChanged);
+                p.removeListener('disconnect', onDisconnect);
+                p.disconnect();
+            },
+            getAccounts,
+            getChainId,
+            getProvider,
+            switchChain,
+            async isAuthorized() {
+                try {
+                    return (await getAccounts()).length > 0;
+                }
+                catch {
+                    return false;
+                }
+            },
+            onAccountsChanged,
+            onChainChanged,
+            onDisconnect,
+        };
+    });
+}
+/** Standalone wagmi connector (for dApps not using RainbowKit). */
+export function orbiConnector(params = {}) {
+    return createConnector(orbiConnectorImpl(params));
+}

package/package.json

@@ -1,12 +1,29 @@
 {
   "name": "@orbi-wallet/sdk",
-  "version": "0.1.3",
-  "description": "Orbi Smart Wallet SDK — connect any Stellar or BotChain dApp to Orbi passkey wallets",
+  "version": "0.2.0",
+  "description": "Orbi Smart Wallet SDK — connect any Stellar or EVM dApp to Orbi passkey wallets",
+  "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": { "types": "./dist/index.d.ts", "default": "./dist/index.js" },
+    "./provider": { "types": "./dist/provider.d.ts", "default": "./dist/provider.js" },
+    "./wagmi": { "types": "./dist/wagmi.d.ts", "default": "./dist/wagmi.js" },
+    "./rainbowkit": { "types": "./dist/rainbowkit.d.ts", "default": "./dist/rainbowkit.js" }
+  },
   "files": [
     "dist"
   ],
+  "peerDependencies": {
+    "@rainbow-me/rainbowkit": "^2",
+    "viem": "^2",
+    "wagmi": "^2"
+  },
+  "peerDependenciesMeta": {
+    "@rainbow-me/rainbowkit": { "optional": true },
+    "viem": { "optional": true },
+    "wagmi": { "optional": true }
+  },
   "license": "MIT",
   "keywords": [
     "stellar",
@@ -23,13 +40,16 @@
     "url": "https://github.com/Novablitz404/orbi-wallet-sdk/issues"
   },
   "scripts": {
-    "prebuild": "node scripts/generate-version.js",
+    "prebuild": "node scripts/generate-version.cjs",
     "build": "tsc",
-    "predev": "node scripts/generate-version.js",
+    "predev": "node scripts/generate-version.cjs",
     "dev": "tsc --watch"
   },
   "devDependencies": {
+    "@rainbow-me/rainbowkit": "^2.2.11",
     "@types/node": "^20.14.2",
-    "typescript": "^5.5.2"
+    "typescript": "^5.5.2",
+    "viem": "^2.52.2",
+    "wagmi": "^2.19.5"
   }
 }