@wormhole-labs/wallet-aggregator-stacks 1.4.0-beta.1

package/README.md

@@ -0,0 +1,3 @@
+## Wallet Aggregator - Stacks
+
+Implements the base abstractions for the Stacks blockchain using `@stacks/connect`.

package/dist/cjs/index.js

@@ -0,0 +1,26 @@
+"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 __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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSupportedWallets = void 0;
+const connect_1 = require("@stacks/connect");
+const stacks_1 = require("./stacks");
+__exportStar(require("./stacks"), exports);
+// TODO: wallet connect support
+const getSupportedWallets = (config) => {
+    return connect_1.DEFAULT_PROVIDERS.map((provider) => new stacks_1.StacksWallet(Object.assign(Object.assign({}, config), { provider })));
+};
+exports.getSupportedWallets = getSupportedWallets;
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,6CAAoD;AAEpD,qCAA4D;AAI5D,2CAAyB;AAEzB,+BAA+B;AACxB,MAAM,mBAAmB,GAAG,CACjC,MAAyB,EACT,EAAE;IAClB,OAAO,2BAAiB,CAAC,GAAG,CAC1B,CAAC,QAAsB,EAAE,EAAE,CAAC,IAAI,qBAAY,iCAAM,MAAM,KAAE,QAAQ,IAAG,CACtE,CAAC;AACJ,CAAC,CAAC;AANW,QAAA,mBAAmB,uBAM9B"}

package/dist/cjs/stacks.js

@@ -0,0 +1,176 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StacksWallet = void 0;
+const connect_1 = require("@stacks/connect");
+const connect_ui_1 = require("@stacks/connect-ui");
+const wallet_aggregator_core_1 = require("@wormhole-labs/wallet-aggregator-core");
+class StacksWallet extends wallet_aggregator_core_1.Wallet {
+    constructor(config) {
+        super();
+        this.provider = config.provider;
+        this.network = config.network;
+        this.walletProvider = (0, connect_ui_1.getProviderFromId)(this.provider.id);
+    }
+    getName() {
+        return this.provider.name;
+    }
+    getUrl() {
+        return this.provider.webUrl || "";
+    }
+    getIcon() {
+        return this.provider.icon || "";
+    }
+    getChainId() {
+        return wallet_aggregator_core_1.CHAIN_ID_STACKS;
+    }
+    getAddresses() {
+        const storage = (0, connect_1.getLocalStorage)();
+        const stacksAddresses = (storage === null || storage === void 0 ? void 0 : storage.addresses.stx) || [];
+        return stacksAddresses.map((addr) => addr.address);
+    }
+    getAddress() {
+        return this.address;
+    }
+    setMainAddress() {
+        throw new wallet_aggregator_core_1.NotSupported();
+    }
+    getBalance() {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new wallet_aggregator_core_1.NotSupported();
+        });
+    }
+    isConnected() {
+        return !!this.address;
+    }
+    getNetworkInfo() {
+        return {
+            network: this.network,
+        };
+    }
+    connect() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Check if the wallet was previously connected.
+            // Avoid calling `getAddresses`, since that prompts the user for approval.
+            if ((0, connect_1.isConnected)()) {
+                const selectedProviderId = (0, connect_1.getSelectedProviderId)();
+                if (selectedProviderId === this.provider.id) {
+                    const addresses = this.getAddresses();
+                    if (addresses.length > 0) {
+                        this.address = addresses[0];
+                        return addresses;
+                    }
+                }
+            }
+            // NOTE: Xverse Wallet throws when network is passed...
+            const network = this.provider.name === "Xverse Wallet" ? undefined : this.network;
+            try {
+                yield (0, connect_1.request)({
+                    provider: this.walletProvider,
+                }, "getAddresses", {
+                    network,
+                });
+                const addresses = this.getAddresses();
+                if (addresses.length === 0) {
+                    throw new Error("No addresses found");
+                }
+                this.address = addresses[0];
+                (0, connect_1.setSelectedProviderId)(this.provider.id);
+                this.emit("connect");
+                return addresses;
+            }
+            catch (error) {
+                throw new Error(`Failed to connect wallet: ${error.message}`);
+            }
+        });
+    }
+    disconnect() {
+        return __awaiter(this, void 0, void 0, function* () {
+            (0, connect_1.disconnect)();
+            this.address = undefined;
+            this.emit("disconnect");
+        });
+    }
+    signTransaction(transaction) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.isConnected()) {
+                throw new wallet_aggregator_core_1.NotConnected();
+            }
+            const result = yield (0, connect_1.request)({
+                provider: this.walletProvider,
+            }, "stx_signTransaction", {
+                transaction,
+                broadcast: false,
+            });
+            return result;
+        });
+    }
+    sendTransaction() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // TODO: @stacks/connect does not provide a way to send a signed transaction?
+            throw new wallet_aggregator_core_1.NotSupported();
+        });
+    }
+    signAndSendTransaction(tx) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.isConnected()) {
+                throw new wallet_aggregator_core_1.NotConnected();
+            }
+            const result = yield (0, connect_1.request)({
+                provider: this.walletProvider,
+            }, "stx_callContract", {
+                contract: `${tx.contractAddress}.${tx.contractName}`,
+                functionName: tx.functionName,
+                functionArgs: tx.functionArgs,
+                network: this.network,
+                address: this.address,
+                fee: tx.fee,
+            });
+            return {
+                id: result.txid || "",
+                data: {
+                    txId: result.txid || "",
+                    txRaw: result.transaction,
+                },
+            };
+        });
+    }
+    signMessage(message) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.isConnected()) {
+                throw new wallet_aggregator_core_1.NotConnected();
+            }
+            const result = yield (0, connect_1.request)({
+                provider: this.walletProvider,
+            }, "stx_signMessage", {
+                message,
+            });
+            return result.signature;
+        });
+    }
+    getWalletState() {
+        return this.walletProvider
+            ? wallet_aggregator_core_1.WalletState.Installed
+            : wallet_aggregator_core_1.WalletState.NotDetected;
+    }
+    getFeatures() {
+        return [
+            wallet_aggregator_core_1.BaseFeatures.SignAndSendTransaction,
+            wallet_aggregator_core_1.BaseFeatures.SignTransaction,
+            wallet_aggregator_core_1.BaseFeatures.SignMessage,
+        ];
+    }
+    supportsChain(chainId) {
+        return chainId === wallet_aggregator_core_1.CHAIN_ID_STACKS;
+    }
+}
+exports.StacksWallet = StacksWallet;
+//# sourceMappingURL=stacks.js.map

package/dist/cjs/stacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stacks.js","sourceRoot":"","sources":["../../src/stacks.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAOyB;AAEzB,mDAAuD;AACvD,kFAQ+C;AAc/C,MAAa,YAAa,SAAQ,+BAAM;IAMtC,YAAY,MAA0B;QACpC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,cAAc,GAAG,IAAA,8BAAiB,EAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;IAClC,CAAC;IAED,UAAU;QACR,OAAO,wCAAe,CAAC;IACzB,CAAC;IAED,YAAY;QACV,MAAM,OAAO,GAAG,IAAA,yBAAe,GAAE,CAAC;QAClC,MAAM,eAAe,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS,CAAC,GAAG,KAAI,EAAE,CAAC;QACrD,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,cAAc;QACZ,MAAM,IAAI,qCAAY,EAAE,CAAC;IAC3B,CAAC;IAEK,UAAU;;YACd,MAAM,IAAI,qCAAY,EAAE,CAAC;QAC3B,CAAC;KAAA;IAED,WAAW;QACT,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,cAAc;QACZ,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;IAEK,OAAO;;YACX,gDAAgD;YAChD,0EAA0E;YAC1E,IAAI,IAAA,qBAAW,GAAE,EAAE,CAAC;gBAClB,MAAM,kBAAkB,GAAG,IAAA,+BAAqB,GAAE,CAAC;gBACnD,IAAI,kBAAkB,KAAK,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;oBACtC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACzB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;wBAC5B,OAAO,SAAS,CAAC;oBACnB,CAAC;gBACH,CAAC;YACH,CAAC;YAED,uDAAuD;YACvD,MAAM,OAAO,GACX,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;YAEpE,IAAI,CAAC;gBACH,MAAM,IAAA,iBAAO,EACX;oBACE,QAAQ,EAAE,IAAI,CAAC,cAAc;iBAC9B,EACD,cAAc,EACd;oBACE,OAAO;iBACR,CACF,CAAC;gBAEF,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC3B,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;gBACxC,CAAC;gBACD,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;gBAE5B,IAAA,+BAAqB,EAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBAExC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAErB,OAAO,SAAS,CAAC;YACnB,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;KAAA;IAEK,UAAU;;YACd,IAAA,oBAAU,GAAE,CAAC;YACb,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1B,CAAC;KAAA;IAEK,eAAe,CAAC,WAAmB;;YACvC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAI,qCAAY,EAAE,CAAC;YAC3B,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAA,iBAAO,EAC1B;gBACE,QAAQ,EAAE,IAAI,CAAC,cAAc;aAC9B,EACD,qBAAqB,EACrB;gBACE,WAAW;gBACX,SAAS,EAAE,KAAK;aACjB,CACF,CAAC;YAEF,OAAO,MAAM,CAAC;QAChB,CAAC;KAAA;IAEK,eAAe;;YACnB,6EAA6E;YAC7E,MAAM,IAAI,qCAAY,EAAE,CAAC;QAC3B,CAAC;KAAA;IAEK,sBAAsB,CAC1B,EAA2B;;YAE3B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAI,qCAAY,EAAE,CAAC;YAC3B,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAA,iBAAO,EAC1B;gBACE,QAAQ,EAAE,IAAI,CAAC,cAAc;aAC9B,EACD,kBAAkB,EAClB;gBACE,QAAQ,EAAE,GAAG,EAAE,CAAC,eAAe,IAAI,EAAE,CAAC,YAAY,EAAE;gBACpD,YAAY,EAAE,EAAE,CAAC,YAAY;gBAC7B,YAAY,EAAE,EAAE,CAAC,YAAY;gBAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,GAAG,EAAE,EAAE,CAAC,GAAG;aACZ,CACF,CAAC;YAEF,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;gBACrB,IAAI,EAAE;oBACJ,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;oBACvB,KAAK,EAAE,MAAM,CAAC,WAAW;iBAC1B;aACF,CAAC;QACJ,CAAC;KAAA;IAEK,WAAW,CAAC,OAAe;;YAC/B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAI,qCAAY,EAAE,CAAC;YAC3B,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAA,iBAAO,EAC1B;gBACE,QAAQ,EAAE,IAAI,CAAC,cAAc;aAC9B,EACD,iBAAiB,EACjB;gBACE,OAAO;aACR,CACF,CAAC;YAEF,OAAO,MAAM,CAAC,SAAS,CAAC;QAC1B,CAAC;KAAA;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,cAAc;YACxB,CAAC,CAAC,oCAAW,CAAC,SAAS;YACvB,CAAC,CAAC,oCAAW,CAAC,WAAW,CAAC;IAC9B,CAAC;IAED,WAAW;QACT,OAAO;YACL,qCAAY,CAAC,sBAAsB;YACnC,qCAAY,CAAC,eAAe;YAC5B,qCAAY,CAAC,WAAW;SACzB,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,OAAe;QAC3B,OAAO,OAAO,KAAK,wCAAe,CAAC;IACrC,CAAC;CACF;AAtMD,oCAsMC"}

package/dist/esm/index.js

@@ -0,0 +1,8 @@
+import { DEFAULT_PROVIDERS } from "@stacks/connect";
+import { StacksWallet } from "./stacks";
+export * from "./stacks";
+// TODO: wallet connect support
+export const getSupportedWallets = (config) => {
+    return DEFAULT_PROVIDERS.map((provider) => new StacksWallet({ ...config, provider }));
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAsB,MAAM,UAAU,CAAC;AAI5D,cAAc,UAAU,CAAC;AAEzB,+BAA+B;AAC/B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,MAAyB,EACT,EAAE;IAClB,OAAO,iBAAiB,CAAC,GAAG,CAC1B,CAAC,QAAsB,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,CACtE,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/stacks.js

@@ -0,0 +1,149 @@
+import { request, disconnect, getLocalStorage, getSelectedProviderId, setSelectedProviderId, isConnected, } from "@stacks/connect";
+import { getProviderFromId } from "@stacks/connect-ui";
+import { BaseFeatures, CHAIN_ID_STACKS, NotSupported, NotConnected, Wallet, WalletState, } from "@wormhole-labs/wallet-aggregator-core";
+export class StacksWallet extends Wallet {
+    constructor(config) {
+        super();
+        this.provider = config.provider;
+        this.network = config.network;
+        this.walletProvider = getProviderFromId(this.provider.id);
+    }
+    getName() {
+        return this.provider.name;
+    }
+    getUrl() {
+        return this.provider.webUrl || "";
+    }
+    getIcon() {
+        return this.provider.icon || "";
+    }
+    getChainId() {
+        return CHAIN_ID_STACKS;
+    }
+    getAddresses() {
+        const storage = getLocalStorage();
+        const stacksAddresses = storage?.addresses.stx || [];
+        return stacksAddresses.map((addr) => addr.address);
+    }
+    getAddress() {
+        return this.address;
+    }
+    setMainAddress() {
+        throw new NotSupported();
+    }
+    async getBalance() {
+        throw new NotSupported();
+    }
+    isConnected() {
+        return !!this.address;
+    }
+    getNetworkInfo() {
+        return {
+            network: this.network,
+        };
+    }
+    async connect() {
+        // Check if the wallet was previously connected.
+        // Avoid calling `getAddresses`, since that prompts the user for approval.
+        if (isConnected()) {
+            const selectedProviderId = getSelectedProviderId();
+            if (selectedProviderId === this.provider.id) {
+                const addresses = this.getAddresses();
+                if (addresses.length > 0) {
+                    this.address = addresses[0];
+                    return addresses;
+                }
+            }
+        }
+        // NOTE: Xverse Wallet throws when network is passed...
+        const network = this.provider.name === "Xverse Wallet" ? undefined : this.network;
+        try {
+            await request({
+                provider: this.walletProvider,
+            }, "getAddresses", {
+                network,
+            });
+            const addresses = this.getAddresses();
+            if (addresses.length === 0) {
+                throw new Error("No addresses found");
+            }
+            this.address = addresses[0];
+            setSelectedProviderId(this.provider.id);
+            this.emit("connect");
+            return addresses;
+        }
+        catch (error) {
+            throw new Error(`Failed to connect wallet: ${error.message}`);
+        }
+    }
+    async disconnect() {
+        disconnect();
+        this.address = undefined;
+        this.emit("disconnect");
+    }
+    async signTransaction(transaction) {
+        if (!this.isConnected()) {
+            throw new NotConnected();
+        }
+        const result = await request({
+            provider: this.walletProvider,
+        }, "stx_signTransaction", {
+            transaction,
+            broadcast: false,
+        });
+        return result;
+    }
+    async sendTransaction() {
+        // TODO: @stacks/connect does not provide a way to send a signed transaction?
+        throw new NotSupported();
+    }
+    async signAndSendTransaction(tx) {
+        if (!this.isConnected()) {
+            throw new NotConnected();
+        }
+        const result = await request({
+            provider: this.walletProvider,
+        }, "stx_callContract", {
+            contract: `${tx.contractAddress}.${tx.contractName}`,
+            functionName: tx.functionName,
+            functionArgs: tx.functionArgs,
+            network: this.network,
+            address: this.address,
+            fee: tx.fee,
+        });
+        return {
+            id: result.txid || "",
+            data: {
+                txId: result.txid || "",
+                txRaw: result.transaction,
+            },
+        };
+    }
+    async signMessage(message) {
+        if (!this.isConnected()) {
+            throw new NotConnected();
+        }
+        const result = await request({
+            provider: this.walletProvider,
+        }, "stx_signMessage", {
+            message,
+        });
+        return result.signature;
+    }
+    getWalletState() {
+        return this.walletProvider
+            ? WalletState.Installed
+            : WalletState.NotDetected;
+    }
+    getFeatures() {
+        return [
+            BaseFeatures.SignAndSendTransaction,
+            BaseFeatures.SignTransaction,
+            BaseFeatures.SignMessage,
+        ];
+    }
+    supportsChain(chainId) {
+        return chainId === CHAIN_ID_STACKS;
+    }
+}
+//# sourceMappingURL=stacks.js.map

package/dist/esm/stacks.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+import { StacksWallet, StacksWalletConfig } from "./stacks";
+export type GetWalletsOptions = Omit<StacksWalletConfig, "provider">;
+export * from "./stacks";
+export declare const getSupportedWallets: (config: GetWalletsOptions) => StacksWallet[];
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE5D,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;AAErE,cAAc,UAAU,CAAC;AAGzB,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,iBAAiB,KACxB,YAAY,EAId,CAAC"}

package/dist/types/stacks.d.ts

@@ -0,0 +1,40 @@
+import type { ContractCallPayload, WbipProvider } from "@stacks/connect";
+import { BaseFeatures, SendTransactionResult, Wallet, WalletState } from "@wormhole-labs/wallet-aggregator-core";
+export interface StacksWalletConfig {
+    provider: WbipProvider;
+    network: "mainnet" | "testnet";
+}
+export type StacksContractCallInput = ContractCallPayload;
+export interface StacksTransactionResult {
+    txId: string;
+    txRaw?: string;
+}
+export declare class StacksWallet extends Wallet {
+    private provider;
+    private network;
+    private walletProvider;
+    private address?;
+    constructor(config: StacksWalletConfig);
+    getName(): string;
+    getUrl(): string;
+    getIcon(): string;
+    getChainId(): 60;
+    getAddresses(): string[];
+    getAddress(): string | undefined;
+    setMainAddress(): void;
+    getBalance(): Promise<string>;
+    isConnected(): boolean;
+    getNetworkInfo(): {
+        network: "mainnet" | "testnet";
+    };
+    connect(): Promise<string[]>;
+    disconnect(): Promise<void>;
+    signTransaction(transaction: string): Promise<import("@stacks/connect/dist/types/methods").SignTransactionResult>;
+    sendTransaction(): Promise<never>;
+    signAndSendTransaction(tx: StacksContractCallInput): Promise<SendTransactionResult<StacksTransactionResult>>;
+    signMessage(message: string): Promise<string>;
+    getWalletState(): WalletState;
+    getFeatures(): BaseFeatures[];
+    supportsChain(chainId: number): boolean;
+}
+//# sourceMappingURL=stacks.d.ts.map

package/dist/types/stacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stacks.d.ts","sourceRoot":"","sources":["../../src/stacks.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EACL,YAAY,EAIZ,qBAAqB,EACrB,MAAM,EACN,WAAW,EACZ,MAAM,uCAAuC,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAE1D,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,YAAa,SAAQ,MAAM;IACtC,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,cAAc,CAAM;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAS;gBAEb,MAAM,EAAE,kBAAkB;IAOtC,OAAO,IAAI,MAAM;IAIjB,MAAM,IAAI,MAAM;IAIhB,OAAO,IAAI,MAAM;IAIjB,UAAU;IAIV,YAAY,IAAI,MAAM,EAAE;IAMxB,UAAU,IAAI,MAAM,GAAG,SAAS;IAIhC,cAAc,IAAI,IAAI;IAIhB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAInC,WAAW,IAAI,OAAO;IAItB,cAAc;;;IAMR,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA6C5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,eAAe,CAAC,WAAW,EAAE,MAAM;IAmBnC,eAAe,IAAI,OAAO,CAAC,KAAK,CAAC;IAKjC,sBAAsB,CAC1B,EAAE,EAAE,uBAAuB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,uBAAuB,CAAC,CAAC;IA6BpD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBnD,cAAc,IAAI,WAAW;IAM7B,WAAW,IAAI,YAAY,EAAE;IAQ7B,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGxC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@wormhole-labs/wallet-aggregator-stacks",
+  "repository": "https://github.com/wormholelabs-xyz/wallet-aggregator-sdk/tree/master/packages/wallets/stacks",
+  "version": "1.4.0-beta.1",
+  "license": "MIT",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "scripts": {
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build": "shx rm -rf dist && npm run build:cjs && npm run build:esm",
+    "clean": "shx rm -rf dist",
+    "prepublish": "npm run build"
+  },
+  "files": [
+    "dist/",
+    "src/"
+  ],
+  "devDependencies": {
+    "@types/node": "^18.19.69",
+    "shx": "^0.3.4",
+    "typescript": "^5.7.2"
+  },
+  "dependencies": {
+    "@stacks/connect": "^8.2.3",
+    "@stacks/connect-ui": "^8.1.1",
+    "@wormhole-labs/wallet-aggregator-core": "1.4.0-beta.1"
+  }
+}

package/src/index.ts

@@ -0,0 +1,16 @@
+import { DEFAULT_PROVIDERS } from "@stacks/connect";
+import type { WbipProvider } from "@stacks/connect";
+import { StacksWallet, StacksWalletConfig } from "./stacks";
+
+export type GetWalletsOptions = Omit<StacksWalletConfig, "provider">;
+
+export * from "./stacks";
+
+// TODO: wallet connect support
+export const getSupportedWallets = (
+  config: GetWalletsOptions
+): StacksWallet[] => {
+  return DEFAULT_PROVIDERS.map(
+    (provider: WbipProvider) => new StacksWallet({ ...config, provider })
+  );
+};

package/src/stacks.ts

@@ -0,0 +1,231 @@
+import {
+  request,
+  disconnect,
+  getLocalStorage,
+  getSelectedProviderId,
+  setSelectedProviderId,
+  isConnected,
+} from "@stacks/connect";
+import type { ContractCallPayload, WbipProvider } from "@stacks/connect";
+import { getProviderFromId } from "@stacks/connect-ui";
+import {
+  BaseFeatures,
+  CHAIN_ID_STACKS,
+  NotSupported,
+  NotConnected,
+  SendTransactionResult,
+  Wallet,
+  WalletState,
+} from "@wormhole-labs/wallet-aggregator-core";
+
+export interface StacksWalletConfig {
+  provider: WbipProvider;
+  network: "mainnet" | "testnet";
+}
+
+export type StacksContractCallInput = ContractCallPayload;
+
+export interface StacksTransactionResult {
+  txId: string;
+  txRaw?: string;
+}
+
+export class StacksWallet extends Wallet {
+  private provider: WbipProvider;
+  private network: "mainnet" | "testnet";
+  private walletProvider: any; // implementation-specific wallet provider
+  private address?: string;
+
+  constructor(config: StacksWalletConfig) {
+    super();
+    this.provider = config.provider;
+    this.network = config.network;
+    this.walletProvider = getProviderFromId(this.provider.id);
+  }
+
+  getName(): string {
+    return this.provider.name;
+  }
+
+  getUrl(): string {
+    return this.provider.webUrl || "";
+  }
+
+  getIcon(): string {
+    return this.provider.icon || "";
+  }
+
+  getChainId() {
+    return CHAIN_ID_STACKS;
+  }
+
+  getAddresses(): string[] {
+    const storage = getLocalStorage();
+    const stacksAddresses = storage?.addresses.stx || [];
+    return stacksAddresses.map((addr) => addr.address);
+  }
+
+  getAddress(): string | undefined {
+    return this.address;
+  }
+
+  setMainAddress(): void {
+    throw new NotSupported();
+  }
+
+  async getBalance(): Promise<string> {
+    throw new NotSupported();
+  }
+
+  isConnected(): boolean {
+    return !!this.address;
+  }
+
+  getNetworkInfo() {
+    return {
+      network: this.network,
+    };
+  }
+
+  async connect(): Promise<string[]> {
+    // Check if the wallet was previously connected.
+    // Avoid calling `getAddresses`, since that prompts the user for approval.
+    if (isConnected()) {
+      const selectedProviderId = getSelectedProviderId();
+      if (selectedProviderId === this.provider.id) {
+        const addresses = this.getAddresses();
+        if (addresses.length > 0) {
+          this.address = addresses[0];
+          return addresses;
+        }
+      }
+    }
+
+    // NOTE: Xverse Wallet throws when network is passed...
+    const network =
+      this.provider.name === "Xverse Wallet" ? undefined : this.network;
+
+    try {
+      await request(
+        {
+          provider: this.walletProvider,
+        },
+        "getAddresses",
+        {
+          network,
+        }
+      );
+
+      const addresses = this.getAddresses();
+      if (addresses.length === 0) {
+        throw new Error("No addresses found");
+      }
+      this.address = addresses[0];
+
+      setSelectedProviderId(this.provider.id);
+
+      this.emit("connect");
+
+      return addresses;
+    } catch (error: any) {
+      throw new Error(`Failed to connect wallet: ${error.message}`);
+    }
+  }
+
+  async disconnect(): Promise<void> {
+    disconnect();
+    this.address = undefined;
+    this.emit("disconnect");
+  }
+
+  async signTransaction(transaction: string) {
+    if (!this.isConnected()) {
+      throw new NotConnected();
+    }
+
+    const result = await request(
+      {
+        provider: this.walletProvider,
+      },
+      "stx_signTransaction",
+      {
+        transaction,
+        broadcast: false,
+      }
+    );
+
+    return result;
+  }
+
+  async sendTransaction(): Promise<never> {
+    // TODO: @stacks/connect does not provide a way to send a signed transaction?
+    throw new NotSupported();
+  }
+
+  async signAndSendTransaction(
+    tx: StacksContractCallInput
+  ): Promise<SendTransactionResult<StacksTransactionResult>> {
+    if (!this.isConnected()) {
+      throw new NotConnected();
+    }
+
+    const result = await request(
+      {
+        provider: this.walletProvider,
+      },
+      "stx_callContract",
+      {
+        contract: `${tx.contractAddress}.${tx.contractName}`,
+        functionName: tx.functionName,
+        functionArgs: tx.functionArgs,
+        network: this.network,
+        address: this.address,
+        fee: tx.fee,
+      }
+    );
+
+    return {
+      id: result.txid || "",
+      data: {
+        txId: result.txid || "",
+        txRaw: result.transaction,
+      },
+    };
+  }
+
+  async signMessage(message: string): Promise<string> {
+    if (!this.isConnected()) {
+      throw new NotConnected();
+    }
+
+    const result = await request(
+      {
+        provider: this.walletProvider,
+      },
+      "stx_signMessage",
+      {
+        message,
+      }
+    );
+
+    return result.signature;
+  }
+
+  getWalletState(): WalletState {
+    return this.walletProvider
+      ? WalletState.Installed
+      : WalletState.NotDetected;
+  }
+
+  getFeatures(): BaseFeatures[] {
+    return [
+      BaseFeatures.SignAndSendTransaction,
+      BaseFeatures.SignTransaction,
+      BaseFeatures.SignMessage,
+    ];
+  }
+
+  supportsChain(chainId: number): boolean {
+    return chainId === CHAIN_ID_STACKS;
+  }
+}