neo-n3-walletkit 0.1.0

package/dist/wallet-connect/adapter.js

@@ -0,0 +1,198 @@
+import { WalletNotConnectedError, WalletRequestError } from "../errors.js";
+const NEO_NAMESPACE = "neo3";
+const COMPATIBILITY_VERSION = 3;
+const DEFAULT_WALLET_URL = "https://neon.coz.io/connect";
+/**
+ * Small Neo-specific adapter around the current WalletConnect Sign Client.
+ */
+export class NeoWalletConnect {
+    signClient;
+    currentSession = null;
+    rawSession = null;
+    listeners = new Set();
+    walletUrl;
+    isManagingSession = false;
+    constructor(client, walletUrl) {
+        this.signClient = client;
+        this.walletUrl = walletUrl ?? DEFAULT_WALLET_URL;
+    }
+    static async init(options) {
+        const { SignClient } = await import("@walletconnect/sign-client");
+        const client = await SignClient.init({
+            projectId: options.projectId,
+            metadata: options.metadata,
+            ...(options.relayUrl ? { relayUrl: options.relayUrl } : {})
+        });
+        return new NeoWalletConnect(client, options.walletUrl);
+    }
+    static fromSignClient(client, walletUrl) {
+        return new NeoWalletConnect(client, walletUrl);
+    }
+    get session() {
+        return this.currentSession;
+    }
+    isConnected() {
+        return this.currentSession !== null;
+    }
+    getChainId() {
+        return this.currentSession?.network ?? null;
+    }
+    getAccountAddress() {
+        return this.currentSession?.accountAddress ?? null;
+    }
+    async manageSession(network, methods = []) {
+        if (!this.isManagingSession) {
+            this.isManagingSession = true;
+            this.signClient.on("session_delete", event => {
+                if (event.topic === this.rawSession?.topic) {
+                    this.setRawSession(null);
+                }
+            });
+            this.signClient.on("session_expire", event => {
+                if (event.topic === this.rawSession?.topic) {
+                    this.setRawSession(null);
+                }
+            });
+            this.signClient.on("session_update", event => {
+                const updated = this.signClient.session.values.find(value => value.topic === event.topic);
+                if (updated) {
+                    this.setRawSession(updated);
+                }
+            });
+        }
+        const session = this.signClient.session.values.find(value => {
+            const namespace = value.namespaces[NEO_NAMESPACE];
+            return (namespace?.accounts.some(account => !network || account.startsWith(`${network}:`)) &&
+                methods.every(method => namespace.methods.includes(method)));
+        }) ?? null;
+        this.setRawSession(session);
+        return this.currentSession;
+    }
+    async connect(network, methods) {
+        const { uri, approval } = await this.createConnection(network, methods);
+        if (uri) {
+            if (typeof window === "undefined") {
+                throw new WalletRequestError("connect() requires a browser window. Use createConnection() for a custom connection flow.", uri);
+            }
+            const connectUrl = new URL(this.walletUrl);
+            connectUrl.searchParams.set("uri", uri);
+            window.open(connectUrl, "_blank")?.focus();
+        }
+        return approval();
+    }
+    async createConnection(network, methods) {
+        const { approval, uri } = await this.signClient.connect({
+            requiredNamespaces: {
+                [NEO_NAMESPACE]: {
+                    chains: [network],
+                    methods,
+                    events: []
+                }
+            }
+        });
+        const approve = async () => {
+            const session = await approval();
+            this.setRawSession(session);
+            return this.currentSession;
+        };
+        return {
+            approval: approve,
+            ...(uri ? { uri: `${uri}&wccv=${COMPATIBILITY_VERSION}` } : {})
+        };
+    }
+    async disconnect() {
+        if (!this.currentSession) {
+            return;
+        }
+        if (!this.rawSession) {
+            this.setRawSession(null);
+            return;
+        }
+        await this.signClient.disconnect({
+            topic: this.rawSession.topic,
+            reason: {
+                code: 5900,
+                message: "USER_DISCONNECTED"
+            }
+        });
+        this.setRawSession(null);
+    }
+    onSessionChange(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    async request(method, params, context) {
+        const session = this.rawSession;
+        if (!session || !this.currentSession) {
+            throw new WalletNotConnectedError();
+        }
+        const chainId = session.namespaces[NEO_NAMESPACE]?.accounts[0]
+            ?.split(":")
+            .slice(0, 2)
+            .join(":") ?? null;
+        if (!chainId) {
+            throw new WalletRequestError("The connected session does not contain a Neo N3 account.", session);
+        }
+        const requestParams = context && params !== null && typeof params === "object" && !Array.isArray(params)
+            ? { ...params, contextualMessage: context }
+            : params;
+        return this.signClient.request({
+            topic: session.topic,
+            chainId,
+            request: {
+                method,
+                params: requestParams
+            }
+        });
+    }
+    setSession(session) {
+        this.currentSession = session;
+        for (const listener of this.listeners) {
+            void listener(session);
+        }
+    }
+    setRawSession(session) {
+        this.rawSession = session;
+        if (!session) {
+            this.setSession(null);
+            return;
+        }
+        const account = session.namespaces[NEO_NAMESPACE]?.accounts[0];
+        const network = account?.split(":").slice(0, 2).join(":");
+        const accountAddress = account?.split(":").slice(2).join(":");
+        const methods = session.namespaces[NEO_NAMESPACE]?.methods ?? [];
+        if (!accountAddress ||
+            (network !== "neo3:private" &&
+                network !== "neo3:testnet" &&
+                network !== "neo3:mainnet")) {
+            this.setSession(null);
+            return;
+        }
+        this.setSession({
+            provider: "walletconnect",
+            network,
+            methods: methods.filter(isMethod),
+            accountAddress,
+            raw: session
+        });
+    }
+}
+function isMethod(value) {
+    return [
+        "invokeFunction",
+        "testInvoke",
+        "signMessage",
+        "verifyMessage",
+        "traverseIterator",
+        "getWalletInfo",
+        "getNetworkVersion",
+        "encrypt",
+        "decrypt",
+        "decryptFromArray",
+        "calculateFee",
+        "signTransaction",
+        "wipeRequests",
+        "withContext"
+    ].includes(value);
+}
+//# sourceMappingURL=adapter.js.map

package/dist/wallet-connect/adapter.js.map

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

package/dist/wallet-connect/index.d.ts

@@ -0,0 +1,3 @@
+export { NeoWalletConnect } from "./adapter.js";
+export type { WalletConnectAdapter, WalletConnectOptions, WalletKitOptions, WalletMetadata } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/wallet-connect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wallet-connect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACf,MAAM,YAAY,CAAC"}

package/dist/wallet-connect/index.js

@@ -0,0 +1,2 @@
+export { NeoWalletConnect } from "./adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/wallet-connect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wallet-connect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/wallet-connect/types.d.ts

@@ -0,0 +1,16 @@
+import type { SignClientTypes } from "@walletconnect/types";
+import type { WalletAdapter, WalletKitClientOptions } from "../types.js";
+export type WalletMetadata = SignClientTypes.Metadata;
+export interface WalletConnectOptions extends WalletKitClientOptions {
+    /** Project ID created at https://cloud.walletconnect.com. */
+    projectId: string;
+    metadata: WalletMetadata;
+    relayUrl?: string;
+    /** Wallet connection page opened by connect(). Defaults to Neon Wallet. */
+    walletUrl?: string;
+}
+/** @deprecated Use WalletConnectOptions. */
+export type WalletKitOptions = WalletConnectOptions;
+/** @deprecated Use WalletAdapter. */
+export type WalletConnectAdapter = WalletAdapter;
+//# sourceMappingURL=types.d.ts.map

package/dist/wallet-connect/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/wallet-connect/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC,QAAQ,CAAC;AAEtD,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB;IAClE,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAEpD,qCAAqC;AACrC,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC"}

package/dist/wallet-connect/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/wallet-connect/types.js.map

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

package/dist/wallet-kit.d.ts

@@ -0,0 +1,40 @@
+import type { ContractInvocationMulti, InvokeResult, Signer } from "@cityofzion/neon-dappkit-types";
+import { NeoContract, type ContractWallet } from "./contract.js";
+import type { ConnectedAccount, ConnectionProposal, ContractOptions, Method, NetworkType, SessionListener, WalletAdapter, WalletKitClientOptions, WalletSession } from "./types.js";
+import { type NeoLineOptions } from "./neoline/index.js";
+import { type OneGateOptions } from "./onegate/index.js";
+import { type WalletConnectOptions } from "./wallet-connect/index.js";
+/**
+ * Framework-independent wallet client for Neo N3 applications.
+ */
+export declare class WalletKit implements ContractWallet {
+    readonly wallet: WalletAdapter;
+    /** @deprecated Use wallet. */
+    readonly walletConnect: WalletAdapter;
+    readonly network: NetworkType;
+    readonly methods: Method[];
+    private constructor();
+    static init(options: WalletConnectOptions): Promise<WalletKit>;
+    static initNeoLine(options?: NeoLineOptions): Promise<WalletKit>;
+    static initOneGate(options?: OneGateOptions): Promise<WalletKit>;
+    /**
+     * Wrap an existing WalletKit-compatible provider adapter.
+     */
+    static fromClient(client: WalletAdapter, options?: WalletKitClientOptions): Promise<WalletKit>;
+    get isConnected(): boolean;
+    get account(): ConnectedAccount | null;
+    connect(): Promise<WalletSession>;
+    createConnection(): Promise<ConnectionProposal>;
+    disconnect(): Promise<void>;
+    onSessionChange(listener: SessionListener): () => void;
+    connectedSigner(scopes?: string | number): Signer;
+    contract(scriptHash: string, options?: ContractOptions): NeoContract;
+    invokeFunction(params: ContractInvocationMulti, context?: string): Promise<string>;
+    testInvoke(params: ContractInvocationMulti, context?: string): Promise<InvokeResult>;
+    private withDefaultSigner;
+    private invokeFunctionInternal;
+    private testInvokeInternal;
+    private requireConnectedAccount;
+    private hasCompatibleSession;
+}
+//# sourceMappingURL=wallet-kit.d.ts.map

package/dist/wallet-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-kit.d.ts","sourceRoot":"","sources":["../src/wallet-kit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,YAAY,EACZ,MAAM,EACP,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAMjE,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,MAAM,EACN,WAAW,EACX,eAAe,EACf,aAAa,EACb,sBAAsB,EACtB,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAC;AAWnC;;GAEG;AACH,qBAAa,SAAU,YAAW,cAAc;IAC9C,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,8BAA8B;IAC9B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAE3B,OAAO;WAUM,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;WAUvD,WAAW,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;WAK7D,WAAW,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;IAK1E;;OAEG;WACU,UAAU,CACrB,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,SAAS,CAAC;IAUrB,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,OAAO,IAAI,gBAAgB,GAAG,IAAI,CAcrC;IAED,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IAIjC,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAI/C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAItD,eAAe,CAAC,MAAM,GAAE,MAAM,GAAG,MAAU,GAAG,MAAM;IAQpD,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,WAAW;IAIxE,cAAc,CACZ,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;IAKlB,UAAU,CACR,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC;IAKxB,OAAO,CAAC,iBAAiB;YAaX,sBAAsB;YAoBtB,kBAAkB;IAiBhC,OAAO,CAAC,uBAAuB;IAS/B,OAAO,CAAC,oBAAoB;CAS7B"}

package/dist/wallet-kit.js

@@ -0,0 +1,137 @@
+import { addressToScriptHash } from "./address.js";
+import { NeoContract } from "./contract.js";
+import { WalletKitError, WalletNotConnectedError, WalletRequestError } from "./errors.js";
+import { NeoLineAdapter } from "./neoline/index.js";
+import { OneGateAdapter } from "./onegate/index.js";
+import { NeoWalletConnect } from "./wallet-connect/index.js";
+const DEFAULT_NETWORK = "neo3:testnet";
+const DEFAULT_METHODS = ["invokeFunction", "testInvoke"];
+function requireText(value, field) {
+    if (value.trim().length === 0) {
+        throw new WalletKitError(`${field} must not be empty.`);
+    }
+}
+/**
+ * Framework-independent wallet client for Neo N3 applications.
+ */
+export class WalletKit {
+    wallet;
+    /** @deprecated Use wallet. */
+    walletConnect;
+    network;
+    methods;
+    constructor(client, options) {
+        this.wallet = client;
+        this.walletConnect = client;
+        this.network = options.network ?? DEFAULT_NETWORK;
+        this.methods = [...(options.methods ?? DEFAULT_METHODS)];
+    }
+    static async init(options) {
+        requireText(options.projectId, "projectId");
+        requireText(options.metadata.name, "metadata.name");
+        requireText(options.metadata.url, "metadata.url");
+        const client = await NeoWalletConnect.init(options);
+        return WalletKit.fromClient(client, options);
+    }
+    static async initNeoLine(options = {}) {
+        const client = await NeoLineAdapter.init(options);
+        return WalletKit.fromClient(client, options);
+    }
+    static async initOneGate(options = {}) {
+        const client = await OneGateAdapter.init(options);
+        return WalletKit.fromClient(client, options);
+    }
+    /**
+     * Wrap an existing WalletKit-compatible provider adapter.
+     */
+    static async fromClient(client, options = {}) {
+        const kit = new WalletKit(client, options);
+        if (options.manageSession !== false) {
+            await client.manageSession(kit.network, kit.methods);
+        }
+        return kit;
+    }
+    get isConnected() {
+        return this.hasCompatibleSession();
+    }
+    get account() {
+        if (!this.hasCompatibleSession()) {
+            return null;
+        }
+        const address = this.wallet.getAccountAddress();
+        if (!address) {
+            return null;
+        }
+        return {
+            address,
+            scriptHash: addressToScriptHash(address)
+        };
+    }
+    connect() {
+        return this.wallet.connect(this.network, this.methods);
+    }
+    createConnection() {
+        return this.wallet.createConnection(this.network, this.methods);
+    }
+    disconnect() {
+        return this.wallet.disconnect();
+    }
+    onSessionChange(listener) {
+        return this.wallet.onSessionChange(listener);
+    }
+    connectedSigner(scopes = 1) {
+        const account = this.requireConnectedAccount();
+        return {
+            account: account.scriptHash,
+            scopes
+        };
+    }
+    contract(scriptHash, options = {}) {
+        return new NeoContract(this, scriptHash, options);
+    }
+    invokeFunction(params, context) {
+        this.requireConnectedAccount();
+        return this.invokeFunctionInternal(this.withDefaultSigner(params), context);
+    }
+    testInvoke(params, context) {
+        this.requireConnectedAccount();
+        return this.testInvokeInternal(this.withDefaultSigner(params), context);
+    }
+    withDefaultSigner(params) {
+        if (params.signers !== undefined) {
+            return params;
+        }
+        return {
+            ...params,
+            signers: [this.connectedSigner()]
+        };
+    }
+    async invokeFunctionInternal(params, context) {
+        const result = await this.wallet.request("invokeFunction", params, context);
+        if (typeof result !== "string") {
+            throw new WalletRequestError("The wallet returned an invalid invokeFunction response.", result);
+        }
+        return result;
+    }
+    async testInvokeInternal(params, context) {
+        const result = await this.wallet.request("testInvoke", params, context);
+        if (!result || result.state !== "HALT") {
+            throw new WalletRequestError("The Neo test invocation failed.", result);
+        }
+        return result;
+    }
+    requireConnectedAccount() {
+        const account = this.account;
+        if (!account) {
+            throw new WalletNotConnectedError();
+        }
+        return account;
+    }
+    hasCompatibleSession() {
+        const session = this.wallet.session;
+        return (this.wallet.isConnected() &&
+            session?.network === this.network &&
+            this.methods.every(method => session.methods.includes(method)));
+    }
+}
+//# sourceMappingURL=wallet-kit.js.map

package/dist/wallet-kit.js.map

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

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "neo-n3-walletkit",
+  "version": "0.1.0",
+  "description": "Framework-independent TypeScript toolkit for connecting frontend applications to Neo N3 wallets.",
+  "keywords": [
+    "neo",
+    "neo-n3",
+    "wallet",
+    "walletconnect",
+    "neoline",
+    "onegate",
+    "nep-21",
+    "dapp",
+    "typescript",
+    "blockchain"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./neoline": {
+      "types": "./dist/neoline/index.d.ts",
+      "import": "./dist/neoline/index.js",
+      "default": "./dist/neoline/index.js"
+    },
+    "./onegate": {
+      "types": "./dist/onegate/index.d.ts",
+      "import": "./dist/onegate/index.js",
+      "default": "./dist/onegate/index.js"
+    },
+    "./wallet-connect": {
+      "types": "./dist/wallet-connect/index.d.ts",
+      "import": "./dist/wallet-connect/index.js",
+      "default": "./dist/wallet-connect/index.js"
+    }
+  },
+  "scripts": {
+    "build": "rimraf dist && tsc -p tsconfig.build.json",
+    "clean": "rimraf dist",
+    "test": "tsx --test test/*.test.ts",
+    "test:watch": "tsx --test --watch test/*.test.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run test && npm run typecheck && npm run build"
+  },
+  "dependencies": {
+    "@cityofzion/neon-dappkit-types": "^1.0.0",
+    "@noble/hashes": "^1.8.0",
+    "@scure/base": "^2.2.0",
+    "@walletconnect/sign-client": "^2.23.9",
+    "@walletconnect/types": "^2.23.9"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.0",
+    "rimraf": "^6.1.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}