sats-connect 0.1.0

package/.github/workflows/release-package.yml

@@ -0,0 +1,33 @@
+name: Release & Publish Package
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 16
+      - run: npm ci
+      # - run: npm test
+
+  publish-gpr:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      packages: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 16
+          registry-url: https://npm.pkg.github.com/
+      - run: npm ci
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}

package/.prettierrc.json

@@ -0,0 +1,13 @@
+{
+  "arrowParens": "always",
+  "bracketSpacing": true,
+  "jsxBracketSameLine": false,
+  "jsxSingleQuote": false,
+  "quoteProps": "as-needed",
+  "singleQuote": true,
+  "semi": true,
+  "printWidth": 100,
+  "useTabs": false,
+  "tabWidth": 2,
+  "trailingComma": "es5"
+}

package/README.md

@@ -0,0 +1 @@
+# sats-connect

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './src/address/index';
+export * from './src/provider/bitcoin.provider';
+export * from './src/auth';

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './src/address/index';
+export * from './src/provider/bitcoin.provider';
+export * from './src/auth';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,YAAY,CAAC"}

package/dist/src/address/index.d.ts

@@ -0,0 +1,3 @@
+import { GetAddressOptions } from './types';
+export declare const openRequestAddressPopup: (options: GetAddressOptions) => Promise<void>;
+export * from './types';

package/dist/src/address/index.js

@@ -0,0 +1,66 @@
+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());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+export var openRequestAddressPopup = function (options) { return __awaiter(void 0, void 0, void 0, function () {
+    var _a, message, network, purpose, provider, addressResponse, error_1;
+    var _b, _c;
+    return __generator(this, function (_d) {
+        switch (_d.label) {
+            case 0:
+                _a = options.payload, message = _a.message, network = _a.network, purpose = _a.purpose;
+                provider = window.BitcoinProvider;
+                if (!provider) {
+                    throw new Error('No Bitcoin Wallet installed');
+                }
+                _d.label = 1;
+            case 1:
+                _d.trys.push([1, 3, , 4]);
+                return [4 /*yield*/, provider.getAddress(purpose, message, network)];
+            case 2:
+                addressResponse = _d.sent();
+                (_b = options.onFinish) === null || _b === void 0 ? void 0 : _b.call(options, addressResponse);
+                return [3 /*break*/, 4];
+            case 3:
+                error_1 = _d.sent();
+                console.error('[Connect] Error during address request', error_1);
+                (_c = options.onCancel) === null || _c === void 0 ? void 0 : _c.call(options);
+                return [3 /*break*/, 4];
+            case 4: return [2 /*return*/];
+        }
+    });
+}); };
+export * from './types';
+//# sourceMappingURL=index.js.map

package/dist/src/address/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/address/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,MAAM,CAAC,IAAM,uBAAuB,GAAG,UAAO,OAA0B;;;;;;gBAChE,KAAgC,OAAO,CAAC,OAAO,EAA7C,OAAO,aAAA,EAAE,OAAO,aAAA,EAAE,OAAO,aAAA,CAAqB;gBAChD,QAAQ,GAAG,MAAM,CAAC,eAAe,CAAC;gBACxC,IAAI,CAAC,QAAQ,EAAE;oBACb,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;iBAChD;;;;gBAEyB,qBAAM,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAA;;gBAAtE,eAAe,GAAG,SAAoD;gBAC5E,MAAA,OAAO,CAAC,QAAQ,wDAAG,eAAe,CAAC,CAAC;;;;gBAEpC,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,OAAK,CAAC,CAAC;gBAC/D,MAAA,OAAO,CAAC,QAAQ,uDAAI,CAAC;;;;;KAExB,CAAC;AAEF,cAAc,SAAS,CAAC"}

package/dist/src/address/types.d.ts

@@ -0,0 +1,16 @@
+import { BitcoinNetwork, Purpose } from '../provider/bitcoin.provider';
+interface GetAddressPayload {
+    purpose: Purpose;
+    message: string;
+    network: BitcoinNetwork;
+}
+export interface GetAddressResponse {
+    address: string;
+    network: string;
+}
+export interface GetAddressOptions {
+    onFinish: (response: GetAddressResponse) => void;
+    onCancel: () => void;
+    payload: GetAddressPayload;
+}
+export {};

package/dist/src/address/types.js

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

package/dist/src/address/types.js.map

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

package/dist/src/auth/index.d.ts

@@ -0,0 +1,11 @@
+import { UserSession } from '@stacks/auth';
+import type { AuthOptions } from './types';
+export declare const isMobile: () => boolean;
+/**
+ * mobile should not use a 'popup' type of window.
+ */
+export declare const shouldUsePopup: () => boolean;
+export declare const getOrCreateUserSession: (userSession?: UserSession) => UserSession;
+export declare const authenticate: (authOptions: AuthOptions) => Promise<void>;
+export declare const getUserData: (userSession?: UserSession) => Promise<import("@stacks/auth").UserData | null>;
+export * from './types';

package/dist/src/auth/index.js

@@ -0,0 +1,126 @@
+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());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { AppConfig, UserSession } from '@stacks/auth';
+import { decodeToken } from 'jsontokens';
+var version = '0.0.1';
+if (typeof window !== 'undefined') {
+    window.__CONNECT_VERSION__ = version;
+}
+export var isMobile = function () {
+    var ua = navigator.userAgent;
+    if (/android/i.test(ua)) {
+        return true;
+    }
+    if (/iPad|iPhone|iPod/.test(ua)) {
+        return true;
+    }
+    return /windows phone/i.test(ua);
+};
+/**
+ * mobile should not use a 'popup' type of window.
+ */
+export var shouldUsePopup = function () {
+    return !isMobile();
+};
+export var getOrCreateUserSession = function (userSession) {
+    if (!userSession) {
+        var appConfig = new AppConfig(['store_write'], document.location.href);
+        userSession = new UserSession({ appConfig: appConfig });
+    }
+    return userSession;
+};
+export var authenticate = function (authOptions) { return __awaiter(void 0, void 0, void 0, function () {
+    var provider, _a, redirectTo, manifestPath, onFinish, onCancel, _b, sendToSignIn, _userSession, appDetails, userSession, transitKey, authRequest, authResponse, token, payload, authResponsePayload, error_1;
+    return __generator(this, function (_c) {
+        switch (_c.label) {
+            case 0:
+                provider = window.BitcoinProvider;
+                if (!provider) {
+                    throw new Error('Unable to authenticate without a Bitcoin Wallet extension');
+                }
+                _a = authOptions.redirectTo, redirectTo = _a === void 0 ? '/' : _a, manifestPath = authOptions.manifestPath, onFinish = authOptions.onFinish, onCancel = authOptions.onCancel, _b = authOptions.sendToSignIn, sendToSignIn = _b === void 0 ? false : _b, _userSession = authOptions.userSession, appDetails = authOptions.appDetails;
+                userSession = getOrCreateUserSession(_userSession);
+                if (userSession.isUserSignedIn()) {
+                    userSession.signUserOut();
+                }
+                transitKey = userSession.generateAndStoreTransitKey();
+                authRequest = userSession.makeAuthRequest(transitKey, "".concat(document.location.origin).concat(redirectTo), "".concat(document.location.origin).concat(manifestPath), userSession.appConfig.scopes, undefined, undefined, {
+                    sendToSignIn: sendToSignIn,
+                    appDetails: appDetails,
+                    connectVersion: version,
+                });
+                _c.label = 1;
+            case 1:
+                _c.trys.push([1, 4, , 5]);
+                return [4 /*yield*/, provider.authenticationRequest(authRequest)];
+            case 2:
+                authResponse = _c.sent();
+                return [4 /*yield*/, userSession.handlePendingSignIn(authResponse)];
+            case 3:
+                _c.sent();
+                token = decodeToken(authResponse);
+                payload = token === null || token === void 0 ? void 0 : token.payload;
+                authResponsePayload = payload;
+                onFinish === null || onFinish === void 0 ? void 0 : onFinish({
+                    authResponse: authResponse,
+                    authResponsePayload: authResponsePayload,
+                    userSession: userSession,
+                });
+                return [3 /*break*/, 5];
+            case 4:
+                error_1 = _c.sent();
+                console.error('[Connect] Error during auth request', error_1);
+                onCancel === null || onCancel === void 0 ? void 0 : onCancel();
+                return [3 /*break*/, 5];
+            case 5: return [2 /*return*/];
+        }
+    });
+}); };
+export var getUserData = function (userSession) { return __awaiter(void 0, void 0, void 0, function () {
+    return __generator(this, function (_a) {
+        userSession = getOrCreateUserSession(userSession);
+        if (userSession.isUserSignedIn()) {
+            return [2 /*return*/, userSession.loadUserData()];
+        }
+        if (userSession.isSignInPending()) {
+            return [2 /*return*/, userSession.handlePendingSignIn()];
+        }
+        return [2 /*return*/, null];
+    });
+}); };
+export * from './types';
+//# sourceMappingURL=index.js.map

package/dist/src/auth/index.js.map

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

package/dist/src/auth/types.d.ts

@@ -0,0 +1,58 @@
+import type { UserSession } from "@stacks/auth";
+export interface AuthResponsePayload {
+    private_key: string;
+    username: string | null;
+    hubUrl: string;
+    associationToken: string;
+    blockstackAPIUrl: string | null;
+    core_token: string | null;
+    email: string | null;
+    exp: number;
+    iat: number;
+    iss: string;
+    jti: string;
+    version: string;
+    profile: any;
+    profile_url: string;
+    public_keys: string[];
+}
+export interface FinishedAuthData {
+    authResponse: string;
+    authResponsePayload: AuthResponsePayload;
+    userSession: UserSession;
+}
+declare global {
+    interface Window {
+        __CONNECT_VERSION__?: string;
+    }
+    const __VERSION__: string;
+}
+export interface AuthOptions {
+    /** The URL you want the user to be redirected to after authentication. */
+    redirectTo?: string;
+    manifestPath?: string;
+    /**
+     * This callback is fired after authentication is finished.
+     * The callback is called with a single object argument, with three keys:
+     * `authResponse`: the raw `authResponse` string that is returned from authentication
+     * `authResponsePayload`: an AuthResponsePayload object
+     * `userSession`: a UserSession object with `userData` included
+     * */
+    onFinish?: (payload: FinishedAuthData) => void;
+    /** This callback is fired if the user exits before finishing */
+    onCancel?: () => void;
+    /**
+     * @deprecated Authentication is no longer supported through a hosted
+     * version. Users must install an extension.
+     */
+    authOrigin?: string;
+    /** If `sendToSignIn` is `true`, then the user will be sent through the sign in flow. */
+    sendToSignIn?: boolean;
+    userSession?: UserSession;
+    appDetails: {
+        /** A human-readable name for your application */
+        name: string;
+        /** A full URL that resolves to an image icon for your application */
+        icon: string;
+    };
+}

package/dist/src/auth/types.js

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

package/dist/src/auth/types.js.map

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

package/dist/src/provider/bitcoin.provider.d.ts

@@ -0,0 +1,22 @@
+import { GetAddressResponse } from '../address';
+export declare enum AddressPurposes {
+    PAYMENT = "payment",
+    ORDINALS = "ordinals"
+}
+export interface Purpose {
+    derivation_path?: string;
+    purpose: AddressPurposes;
+}
+export interface BitcoinNetwork {
+    type: string;
+    address: string;
+}
+export interface BitcoinProvider {
+    getAddress: (purpose: Purpose, message: string, network?: BitcoinNetwork) => Promise<GetAddressResponse>;
+    authenticationRequest(payload: string): Promise<string>;
+}
+declare global {
+    interface Window {
+        BitcoinProvider?: BitcoinProvider;
+    }
+}

package/dist/src/provider/bitcoin.provider.js

@@ -0,0 +1,6 @@
+export var AddressPurposes;
+(function (AddressPurposes) {
+    AddressPurposes["PAYMENT"] = "payment";
+    AddressPurposes["ORDINALS"] = "ordinals";
+})(AddressPurposes || (AddressPurposes = {}));
+//# sourceMappingURL=bitcoin.provider.js.map

package/dist/src/provider/bitcoin.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcoin.provider.js","sourceRoot":"","sources":["../../../src/provider/bitcoin.provider.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,sCAAmB,CAAA;IACnB,wCAAqB,CAAA;AACvB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B"}

package/index.ts

@@ -0,0 +1,4 @@
+export * from './src/address/index';
+export * from './src/provider';
+export * from './src/call';
+export * from './src/transactions/signPsbt';

package/jest.config.js

@@ -0,0 +1,5 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  testPathIgnorePatterns: ['dist'],
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "sats-connect",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "scripts": {
+    "test": "jest",
+    "build-debug": "webpack --mode development",
+    "build": "npm run clean && tsc --module ES6 --outDir ./dist",
+    "clean": "rimraf dist",
+    "lint": "prettier --write ."
+  },
+  "dependencies": {
+    "jsontokens": "^4.0.1",
+    "process": "^0.11.10",
+    "util": "^0.12.4"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.2.6",
+    "prettier": "^2.8.4",
+    "process": "^0.11.10",
+    "rimraf": "^3.0.2",
+    "stream-browserify": "^3.0.0",
+    "ts-jest": "^29.0.5",
+    "ts-loader": "^9.4.1",
+    "typescript": "^4.9.4",
+    "vm-browserify": "^1.1.2",
+    "webpack": "^5.74.0",
+    "webpack-cli": "^4.10.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/secretkeylabs/sats-connect.git"
+  },
+  "author": "Secret Key Labs",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/secretkeylabs/sats-connect/issues"
+  },
+  "homepage": "https://github.com/secretkeylabs/sats-connect#readme"
+}

package/src/address/index.ts

@@ -0,0 +1,23 @@
+import { createUnsecuredToken, Json } from 'jsontokens';
+import { GetAddressOptions } from './types';
+
+export const openConnectPopup = async (options: GetAddressOptions) => {
+  const { message, network, purposes } = options.payload;
+  const provider = window.BitcoinProvider;
+  if (!provider) {
+    throw new Error('No Bitcoin Wallet installed');
+  }
+  if(!purposes) {
+    throw new Error('Address purposes are required');
+  }
+  try {
+    const request = createUnsecuredToken(options.payload as unknown as Json);
+    const addressResponse = await provider.connect(request);
+    options.onFinish?.(addressResponse);
+  } catch (error) {
+    console.error('[Connect] Error during address request', error);
+    options.onCancel?.();
+  }
+};
+
+export * from './types';

package/src/address/types.ts

@@ -0,0 +1,33 @@
+import { BitcoinNetwork } from '../provider';
+
+export enum AddressPurposes {
+  PAYMENT = 'payment',
+  ORDINALS = 'ordinals',
+}
+
+export interface Purpose {
+  derivation_path?: string;
+  purpose: AddressPurposes;
+}
+
+export interface GetAddressPayload {
+  purposes: Array<Purpose>;
+  message: string;
+  network: BitcoinNetwork;
+}
+
+export interface Address {
+  address: string;
+  publicKey: string;
+  purpose: Purpose;
+}
+
+export interface GetAddressResponse {
+  addresses: Array<Address>
+}
+
+export interface GetAddressOptions {
+  onFinish: (response: GetAddressResponse) => void;
+  onCancel: () => void;
+  payload: GetAddressPayload;
+}

package/src/call/index.ts

@@ -0,0 +1,38 @@
+import { createUnsecuredToken, Json } from 'jsontokens';
+import { BitcoinNetwork } from '../provider';
+
+export interface CallWalletPayload {
+  method: string;
+  network: BitcoinNetwork;
+  params?: Array<any>;
+}
+
+export interface CallWalletOptions {
+  onFinish: (response: Record<string, any>) => void;
+  onCancel: () => void;
+  payload: CallWalletPayload;
+}
+
+export enum CallMethod {
+  SIGN_PSBT = 'signPsbt',
+  GET_ADDRESS = 'getAddress',
+}
+
+export const callWalletPopup = async (options: CallWalletOptions) => {
+  const provider = window.BitcoinProvider;
+  const { method } = options.payload;
+  if (!provider) {
+    throw new Error('No Bitcoin Wallet installed');
+  }
+  if(!method) {
+    throw new Error('A wallet method is required');
+  }
+  const request = createUnsecuredToken(options.payload as unknown as Json);
+  try {
+    const callResponse = await provider.call(request);
+    options.onFinish?.(callResponse);
+  } catch (error) {
+    console.error('[Connect] Error during call request', error);
+    options.onCancel?.();
+  }
+};

package/src/provider/index.ts

@@ -0,0 +1,19 @@
+import { SignPsbtResponse } from '../transactions/signPsbt';
+import { GetAddressResponse } from '../address';
+
+export interface BitcoinNetwork {
+  type: string;
+  address: string;
+}
+
+export interface BitcoinProvider {
+  connect: (request: string) => Promise<GetAddressResponse>;
+  call: (request: string) => Promise<Record<string, any>>;
+  signPsbt: (request: string) => Promise<SignPsbtResponse>;
+}
+
+declare global {
+  interface Window {
+    BitcoinProvider?: BitcoinProvider;
+  }
+}

package/src/transactions/signPsbt.ts

@@ -0,0 +1,50 @@
+import { createUnsecuredToken, Json } from 'jsontokens';
+import { BitcoinNetwork } from '../provider';
+
+
+export interface InputToSign {
+  address: string,
+  signingIndexes: Array<number>,
+  sigHash?: number,
+}
+
+
+export interface SignPsbtPayload {
+  network: BitcoinNetwork;
+  message: string;
+  psbtBase64: string;
+  broadcast?: boolean;
+  inputsToSign: InputToSign[];
+}
+
+export interface SignPsbtOptions {
+  payload: SignPsbtPayload;
+  onFinish: (response: any) => void;
+  onCancel: () => void;
+}
+
+export interface SignPsbtResponse {
+  psbtBase64: string;
+  txId?: string;
+}
+
+
+export const openSignPsbtPopup = async (options: SignPsbtOptions) => {
+  const { psbtBase64 } = options.payload;
+  const provider = window.BitcoinProvider;
+  if (!provider) {
+    throw new Error('No Bitcoin Wallet installed');
+  }
+  if (!psbtBase64) {
+    throw new Error('a value for psbtBase64 representing the tx hash is required');
+  }
+    try {
+      const request = createUnsecuredToken(options.payload as unknown as Json);
+      const addressResponse = await provider.signPsbt(request);
+      options.onFinish?.(addressResponse);
+    } catch (error) {
+      console.error('[Connect] Error during signPsbt request', error);
+      options.onCancel?.();
+    }
+};
+

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "incremental": true,
+    "module": "es6",
+    "target": "es5",
+    "moduleResolution": "node",
+    "baseUrl": ".",
+    "declaration": true,
+    "sourceMap": true,
+    "outDir": "dist",
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "useUnknownInCatchVariables": false,
+    "noImplicitAny": true,
+    "allowUnreachableCode": false,
+    "skipLibCheck": true
+  },
+  "exclude": ["./tests", "./dist"]
+}

package/webpack.config.js

@@ -0,0 +1,53 @@
+const webpack = require('webpack');
+const path = require('path');
+
+const NODE_ENV_PRODUCTION = 'production';
+const NODE_ENV_DEVELOPMENT = 'development';
+
+const isProduction = process.env.NODE_ENV === NODE_ENV_PRODUCTION;
+
+module.exports = {
+  mode: isProduction ? NODE_ENV_PRODUCTION : NODE_ENV_DEVELOPMENT,
+  entry: ['./index.ts'],
+  output: {
+    filename: 'index.js',
+    library: 'sats_connect',
+    libraryTarget: 'var',
+    path: path.resolve(process.cwd(), 'dist'),
+  },
+  plugins: [
+    new webpack.ProvidePlugin({
+      process: 'process/browser',
+      fetch: 'cross-fetch',
+    }),
+  ],
+  optimization: {
+    minimize: isProduction,
+  },
+  devtool: false,
+  module: {
+    rules: [
+      {
+        test: /\.[jt]sx?$/,
+        exclude: /node_modules/,
+        use: [
+          {
+            loader: require.resolve('ts-loader'),
+            options: {
+              transpileOnly: false,
+            },
+          },
+        ],
+      },
+    ],
+  },
+  resolve: {
+    extensions: ['.ts', '.js'],
+    fallback: {
+      url: require.resolve('url'),
+      stream: require.resolve('stream-browserify'),
+      vm: require.resolve('vm-browserify'),
+      assert: require.resolve('assert'),
+    },
+  },
+};