@1sat/wallet-server 0.0.29 → 0.0.32

package/dist/hosting/routes.js

@@ -0,0 +1,239 @@
+/**
+ * Hosting subscription routes on the wallet server.
+ *
+ * GET  /hosting/price   — public (mounted before global auth when possible)
+ * GET  /hosting/status  — BRC-100 auth
+ * POST /hosting/subscribe — BRC-100 auth + 402 → spend prior receipt(s), mint one new
+ *
+ * Receipt: 1-sat to host, basket HOSTING_BASKET, wallet-local tags only
+ * (payer:{id}, exp:{unix}). No customer identity on-chain.
+ * At most one live receipt set per identity: renew spends all prior.
+ */
+import { HOSTING_BASKET, P1SAT_PROTOCOL, hostingExpTag, hostingPayerTag, readHostingExp, } from '@1sat/types';
+import { Hash, P2PKH, PublicKey, Transaction, TransactionSignature, UnlockingScript, Utils, } from '@bsv/sdk';
+import { createAccountsPaymentMiddleware } from '../accounts/paymentMiddleware';
+export function mountHostingRoutes(app, basePath, deps) {
+    const root = basePath === '/' ? '' : basePath.replace(/\/$/, '');
+    // GET /hosting/price is mounted in createWalletServer *before* auth.
+    app.get(`${root}/hosting/status`, deps.authMiddleware, async (req, res) => {
+        const cfg = deps.getConfig();
+        const identityKey = req.auth?.identityKey;
+        if (!identityKey || identityKey === 'unknown') {
+            return res.status(401).json({ error: 'unauthenticated' });
+        }
+        if (!cfg.enabled) {
+            return res.json({
+                enabled: false,
+                identityKey,
+                active: false,
+            });
+        }
+        const status = await hostingStatus(deps.wallet, identityKey);
+        return res.json({
+            enabled: true,
+            identityKey,
+            ...status,
+            priceSats: cfg.priceSats,
+            ...(cfg.priceUsd !== undefined && { priceUsd: cfg.priceUsd }),
+            periodSeconds: cfg.periodSeconds,
+        });
+    });
+    const paymentMw = createAccountsPaymentMiddleware({
+        wallet: deps.wallet,
+        calculateRequestPrice: async () => {
+            const cfg = deps.getConfig();
+            return cfg.enabled ? cfg.priceSats : 0;
+        },
+        onPaymentInternalize: (_req, defaults) => ({
+            ...defaults,
+            description: 'Hosted paymail subscription',
+            labels: ['hosting-payment'],
+        }),
+    });
+    app.post(`${root}/hosting/subscribe`, deps.authMiddleware, paymentMw, async (req, res) => {
+        const cfg = deps.getConfig();
+        const identityKey = req.auth?.identityKey;
+        if (!identityKey || identityKey === 'unknown') {
+            return res.status(401).json({ error: 'unauthenticated' });
+        }
+        if (!cfg.enabled) {
+            return res.status(404).json({ error: 'hosting disabled' });
+        }
+        try {
+            const result = await mintOrReplaceReceipt(deps.wallet, identityKey, cfg.periodSeconds);
+            return res.json({
+                status: 'ok',
+                identityKey,
+                expiresAt: result.expiresAt,
+                txid: result.txid,
+            });
+        }
+        catch (err) {
+            console.error('[hosting] mint receipt failed', err);
+            return res.status(500).json({
+                error: err instanceof Error ? err.message : 'mint failed',
+            });
+        }
+    });
+}
+async function listReceipts(wallet, identityKey, withBeef) {
+    const result = await wallet.listOutputs({
+        basket: HOSTING_BASKET,
+        tags: [hostingPayerTag(identityKey)],
+        tagQueryMode: 'all',
+        includeTags: true,
+        includeCustomInstructions: true,
+        ...(withBeef ? { include: 'entire transactions' } : {}),
+        limit: 100,
+    });
+    return {
+        outputs: result.outputs,
+        BEEF: result.BEEF ? Array.from(result.BEEF) : undefined,
+    };
+}
+async function hostingStatus(wallet, identityKey) {
+    const { outputs } = await listReceipts(wallet, identityKey, false);
+    const now = Math.floor(Date.now() / 1000);
+    // After correct mint, at most one — still take max if legacy junk exists.
+    let maxExp = 0;
+    for (const o of outputs) {
+        const exp = readHostingExp(o.tags);
+        if (exp !== undefined && exp > maxExp)
+            maxExp = exp;
+    }
+    return {
+        active: maxExp > now,
+        expiresAt: maxExp > 0 ? maxExp : undefined,
+    };
+}
+/**
+ * Spend all existing receipts for identity, create exactly one new receipt
+ * with exp = max(now, priorExp) + periodSeconds.
+ */
+async function mintOrReplaceReceipt(wallet, identityKey, periodSeconds) {
+    const now = Math.floor(Date.now() / 1000);
+    const { outputs: existing, BEEF } = await listReceipts(wallet, identityKey, true);
+    let priorExp = now;
+    for (const o of existing) {
+        const exp = readHostingExp(o.tags);
+        if (exp !== undefined && exp > priorExp)
+            priorExp = exp;
+    }
+    const expiresAt = priorExp + periodSeconds;
+    const keyID = `hosting-${expiresAt}-${identityKey.slice(0, 8)}`;
+    const { publicKey } = await wallet.getPublicKey({
+        protocolID: P1SAT_PROTOCOL,
+        keyID,
+        counterparty: 'self',
+        forSelf: true,
+    });
+    const lockingScript = new P2PKH()
+        .lock(PublicKey.fromString(publicKey).toAddress())
+        .toHex();
+    const inputs = existing.map((o) => ({
+        outpoint: o.outpoint,
+        inputDescription: 'Replace hosting receipt',
+        unlockingScriptLength: 108,
+    }));
+    const created = await wallet.createAction({
+        description: 'Hosting subscription receipt',
+        ...(inputs.length > 0 && {
+            inputs,
+            inputBEEF: BEEF,
+        }),
+        outputs: [
+            {
+                lockingScript,
+                satoshis: 1,
+                outputDescription: 'Hosting receipt',
+                basket: HOSTING_BASKET,
+                tags: [hostingPayerTag(identityKey), hostingExpTag(expiresAt)],
+                customInstructions: JSON.stringify({
+                    protocolID: P1SAT_PROTOCOL,
+                    keyID,
+                    counterparty: 'self',
+                }),
+            },
+        ],
+        options: { randomizeOutputs: false },
+    });
+    if (!created.txid && !created.signableTransaction) {
+        throw new Error('createAction returned no txid');
+    }
+    if (created.signableTransaction && existing.length > 0) {
+        const tx = Transaction.fromAtomicBEEF(created.signableTransaction.tx);
+        const spends = {};
+        for (let i = 0; i < existing.length; i++) {
+            const o = existing[i];
+            if (!o.customInstructions) {
+                throw new Error(`missing customInstructions on ${o.outpoint}`);
+            }
+            const ci = JSON.parse(o.customInstructions);
+            const unlocking = await signP2PKH(wallet, tx, i, ci.protocolID, ci.keyID, ci.counterparty ?? 'self');
+            spends[i] = { unlockingScript: unlocking };
+        }
+        const signed = await wallet.signAction({
+            reference: created.signableTransaction.reference,
+            spends,
+        });
+        if (!signed.txid)
+            throw new Error('signAction returned no txid');
+        return { expiresAt, txid: signed.txid };
+    }
+    if (!created.txid)
+        throw new Error('createAction returned no txid');
+    return { expiresAt, txid: created.txid };
+}
+async function signP2PKH(wallet, tx, inputIndex, protocolID, keyID, counterparty) {
+    const txInput = tx.inputs[inputIndex];
+    const sourceLockingScript = txInput.sourceTransaction?.outputs[txInput.sourceOutputIndex]?.lockingScript;
+    if (!sourceLockingScript) {
+        throw new Error(`missing source locking script for input ${inputIndex}`);
+    }
+    const sourceTXID = txInput.sourceTXID ?? txInput.sourceTransaction?.id('hex');
+    if (!sourceTXID)
+        throw new Error(`missing source txid for input ${inputIndex}`);
+    const sourceSatoshis = txInput.sourceTransaction?.outputs[txInput.sourceOutputIndex]?.satoshis ?? 1;
+    const preimage = TransactionSignature.format({
+        sourceTXID,
+        sourceOutputIndex: txInput.sourceOutputIndex,
+        sourceSatoshis,
+        transactionVersion: tx.version,
+        otherInputs: tx.inputs
+            .filter((_, idx) => idx !== inputIndex)
+            .map((inp) => ({
+            sourceTXID: inp.sourceTXID ?? inp.sourceTransaction?.id('hex') ?? '',
+            sourceOutputIndex: inp.sourceOutputIndex,
+            sequence: inp.sequence ?? 0xffffffff,
+        })),
+        inputIndex,
+        outputs: tx.outputs,
+        inputSequence: txInput.sequence ?? 0xffffffff,
+        subscript: sourceLockingScript,
+        lockTime: tx.lockTime,
+        scope: TransactionSignature.SIGHASH_ALL | TransactionSignature.SIGHASH_FORKID,
+    });
+    const sighash = Hash.sha256(Hash.sha256(preimage));
+    const { signature } = await wallet.createSignature({
+        protocolID,
+        keyID,
+        counterparty,
+        data: Array.from(preimage),
+        hashToDirectlySign: Array.from(sighash),
+    });
+    const { publicKey } = await wallet.getPublicKey({
+        protocolID,
+        keyID,
+        counterparty,
+        forSelf: true,
+    });
+    const sigWithHashtype = [
+        ...signature,
+        TransactionSignature.SIGHASH_ALL | TransactionSignature.SIGHASH_FORKID,
+    ];
+    return new UnlockingScript()
+        .writeBin(sigWithHashtype)
+        .writeBin(Utils.toArray(publicKey, 'hex'))
+        .toHex();
+}
+//# sourceMappingURL=routes.js.map

package/dist/hosting/routes.js.map

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

package/dist/index.d.ts

@@ -15,4 +15,14 @@ export * from './resolvers';
 export * from './accounts';
 export type { IdentityResolver, JsonRpcRequest, JsonRpcResponse, JsonRpcResponseErr, JsonRpcResponseOk, PreDispatchContext, PreDispatchHook, PreDispatchResult, ResolvedIdentity, WalletRpcHandlerConfig, WalletStorageProvider, } from './types';
 export type { WalletServerAccounts } from './createWalletServer';
+export { createHostServer } from './createHostServer';
+export type { HostServerConfig, HostServerHandle, HostServerMessageboxConfig, } from './createHostServer';
+export { mountPaymailRoutes } from './paymail/routes';
+export { KnexPendingStore, DEFAULT_TTL_MS } from './paymail/pending';
+export { checkHostingEntitlement } from './paymail/entitlement';
+export type { PaymailDeps, PendingPayment, PendingStore, ResolvedBind, } from './paymail/types';
+export { mountHostingRoutes, type HostingConfig, type HostingConfigProvider, } from './hosting/routes';
+export { HostingClient, type HostingPrice, type HostingStatus, type HostingSubscribeResult, } from './hosting/client';
+export { buildOpenApiSpec, mountOpenApiRoutes } from './openapi';
+export type { OpenApiOptions, OpenApiSurfaces } from './openapi';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EACX,kBAAkB,EAClB,kBAAkB,GAClB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EACX,kBAAkB,EAClB,kBAAkB,GAClB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,YAAY,EACX,mBAAmB,EACnB,mBAAmB,GACnB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACzE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEhE,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAE1B,YAAY,EACX,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,GACrB,MAAM,SAAS,CAAA;AAEhB,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EACX,kBAAkB,EAClB,kBAAkB,GAClB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EACX,kBAAkB,EAClB,kBAAkB,GAClB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,YAAY,EACX,mBAAmB,EACnB,mBAAmB,GACnB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACzE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEhE,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAE1B,YAAY,EACX,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,GACrB,MAAM,SAAS,CAAA;AAEhB,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,YAAY,EACX,gBAAgB,EAChB,gBAAgB,EAChB,0BAA0B,GAC1B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,YAAY,EACX,WAAW,EACX,cAAc,EACd,YAAY,EACZ,YAAY,GACZ,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACN,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,qBAAqB,GAC1B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACN,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,sBAAsB,GAC3B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAChE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -7,4 +7,11 @@ export { createWalletMonitor } from './createWalletMonitor';
 export { BILLABLE_METHODS, dispatch, isBillableMethod } from './dispatch';
 export * from './resolvers';
 export * from './accounts';
+export { createHostServer } from './createHostServer';
+export { mountPaymailRoutes } from './paymail/routes';
+export { KnexPendingStore, DEFAULT_TTL_MS } from './paymail/pending';
+export { checkHostingEntitlement } from './paymail/entitlement';
+export { mountHostingRoutes, } from './hosting/routes';
+export { HostingClient, } from './hosting/client';
+export { buildOpenApiSpec, mountOpenApiRoutes } from './openapi';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AAGjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAMzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAMzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAGtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAM3D,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAGzE,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AAGjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAMzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAMzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAGtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAM3D,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAGzE,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAiB1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAMrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAO/D,OAAO,EACN,kBAAkB,GAGlB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACN,aAAa,GAIb,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}

package/dist/openapi/fragments.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Per-surface OpenAPI path fragments. Each surface contributes its canonical
+ * paths only — legacy root-mounted messagebox aliases are intentionally
+ * undocumented. The assembler merges fragments for enabled surfaces.
+ */
+export type PathsFragment = Record<string, Record<string, unknown>>;
+export interface TagDoc {
+    name: string;
+    'x-displayName': string;
+    description: string;
+}
+/** Tag metadata rendered as section headings + intros on the docs page. */
+export declare const TAG_DOCS: TagDoc[];
+export declare function authPaths(): PathsFragment;
+export declare function storagePaths(): PathsFragment;
+export declare function accountPaths(): PathsFragment;
+export declare function hostingPaths(): PathsFragment;
+export declare function messageboxPaths(): PathsFragment;
+export declare function paymailPaths(): PathsFragment;
+//# sourceMappingURL=fragments.d.ts.map

package/dist/openapi/fragments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragments.d.ts","sourceRoot":"","sources":["../../src/openapi/fragments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAEnE,MAAM,WAAW,MAAM;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;CACnB;AAED,2EAA2E;AAC3E,eAAO,MAAM,QAAQ,EAAE,MAAM,EAqC5B,CAAA;AA6BD,wBAAgB,SAAS,IAAI,aAAa,CAczC;AAED,wBAAgB,YAAY,IAAI,aAAa,CAkC5C;AAED,wBAAgB,YAAY,IAAI,aAAa,CAiE5C;AAED,wBAAgB,YAAY,IAAI,aAAa,CAwF5C;AAED,wBAAgB,eAAe,IAAI,aAAa,CA6H/C;AAED,wBAAgB,YAAY,IAAI,aAAa,CAc5C"}