@1sat/wallet-server 0.0.1

package/dist/createWalletServer.js

@@ -0,0 +1,183 @@
+import { createAuthMiddleware } from '@bsv/auth-express-middleware';
+import { PrivateKey, ProtoWallet, PublicKey, } from '@bsv/sdk';
+import express from 'express';
+import { AccountsGate } from './accounts';
+import { createWalletRpcHandler } from './createWalletRpcHandler';
+import { dispatch } from './dispatch';
+import { bearerResolver } from './resolvers/bearer';
+export function createWalletServer(config) {
+    const publicPath = config.publicPath === undefined ? '/' : config.publicPath;
+    const internalPath = config.internalPath === undefined ? '/internal' : config.internalPath;
+    if (!publicPath && !internalPath) {
+        throw new Error('createWalletServer requires at least one of publicPath or internalPath');
+    }
+    if (internalPath && !config.internalAPIKey) {
+        throw new Error('internalAPIKey is required when internalPath is enabled');
+    }
+    const app = express();
+    app.use(express.json({ limit: config.bodyLimit ?? '30mb' }));
+    app.use(corsMiddleware);
+    const wallet = buildServerWallet(config.serverPrivateKey);
+    const serverIdentityKey = identityKeyFromPrivateKey(config.serverPrivateKey);
+    let gate;
+    if (config.accounts?.config.enabled) {
+        const deps = {
+            config: config.accounts.config,
+            walletStorage: config.storage,
+            knex: config.accounts.knex,
+            wallet,
+            serverIdentityKey,
+            currentBlock: config.accounts.currentBlock,
+        };
+        gate = new AccountsGate(deps);
+    }
+    if (publicPath) {
+        mountPublicRoute(app, publicPath, config, wallet, gate);
+    }
+    if (internalPath) {
+        mountInternalRoute(app, internalPath, config, gate);
+    }
+    let server;
+    return {
+        app,
+        start() {
+            return new Promise((resolve, reject) => {
+                server = app.listen(config.listen.port, config.listen.host ?? '0.0.0.0', () => {
+                    const address = server?.address();
+                    const port = typeof address === 'object' && address
+                        ? address.port
+                        : config.listen.port;
+                    resolve(port);
+                });
+                server.on('error', reject);
+            });
+        },
+        stop() {
+            return new Promise((resolve, reject) => {
+                if (!server)
+                    return resolve();
+                server.close((err) => (err ? reject(err) : resolve()));
+            });
+        },
+    };
+}
+function mountPublicRoute(app, path, config, wallet, gate) {
+    const authMiddleware = createAuthMiddleware({ wallet });
+    app.use(path, authMiddleware);
+    app.post(path, async (req, res) => {
+        const identityKey = req.auth?.identityKey;
+        if (!identityKey || identityKey === 'unknown') {
+            return res.status(401).json({
+                jsonrpc: '2.0',
+                error: { code: -32000, message: 'Unauthenticated' },
+                id: req.body?.id ?? null,
+            });
+        }
+        const body = req.body;
+        if (!isJsonRpcLike(body)) {
+            return res.status(400).json({
+                jsonrpc: '2.0',
+                error: { code: -32600, message: 'Invalid Request' },
+                id: body?.id ?? null,
+            });
+        }
+        const id = normalizeJsonRpcId(body.id);
+        if (gate) {
+            const decision = await gate.check({
+                method: body.method,
+                identity: { identityKey },
+                request: expressToFetchRequest(req),
+                id,
+            });
+            if (decision.type === 'blocked') {
+                return relayFetchResponse(res, decision.response);
+            }
+        }
+        const response = await dispatch({
+            storage: config.storage,
+            adminIdentityKeys: config.adminIdentityKeys,
+            makeLogger: config.makeLogger,
+        }, {
+            method: body.method,
+            params: Array.isArray(body.params) ? body.params : [],
+            id,
+            identity: { identityKey },
+        });
+        res.status(200).json(response);
+    });
+}
+async function relayFetchResponse(res, fetchRes) {
+    res.status(fetchRes.status);
+    fetchRes.headers.forEach((v, k) => res.set(k, v));
+    const buf = Buffer.from(await fetchRes.arrayBuffer());
+    res.send(buf);
+}
+function mountInternalRoute(app, path, config, gate) {
+    const preDispatch = gate
+        ? (ctx) => gate.check(ctx)
+        : undefined;
+    const handler = createWalletRpcHandler({
+        storage: config.storage,
+        resolveIdentity: bearerResolver({
+            token: config.internalAPIKey,
+            identityHeader: config.internalIdentityHeader,
+        }),
+        adminIdentityKeys: config.adminIdentityKeys,
+        makeLogger: config.makeLogger,
+        preDispatch,
+    });
+    app.post(path, async (req, res) => {
+        const fetchReq = expressToFetchRequest(req);
+        const fetchRes = await handler(fetchReq);
+        res.status(fetchRes.status);
+        fetchRes.headers.forEach((v, k) => res.set(k, v));
+        const buf = Buffer.from(await fetchRes.arrayBuffer());
+        res.send(buf);
+    });
+}
+function buildServerWallet(privateKeyHex) {
+    const key = PrivateKey.fromHex(privateKeyHex);
+    return new ProtoWallet(key);
+}
+function identityKeyFromPrivateKey(privateKeyHex) {
+    const key = PrivateKey.fromHex(privateKeyHex);
+    const pub = PublicKey.fromPrivateKey(key);
+    return pub.toString();
+}
+function corsMiddleware(_req, res, next) {
+    res.header('Access-Control-Allow-Origin', '*');
+    res.header('Access-Control-Allow-Headers', '*');
+    res.header('Access-Control-Allow-Methods', '*');
+    res.header('Access-Control-Expose-Headers', '*');
+    next();
+}
+function isJsonRpcLike(body) {
+    if (typeof body !== 'object' || body === null)
+        return false;
+    const b = body;
+    return b.jsonrpc === '2.0' && typeof b.method === 'string';
+}
+function normalizeJsonRpcId(id) {
+    if (typeof id === 'string' || typeof id === 'number')
+        return id;
+    return null;
+}
+function expressToFetchRequest(req) {
+    const protocol = req.headers['x-forwarded-proto'] ?? 'http';
+    const host = req.headers.host ?? 'localhost';
+    const url = new URL(req.originalUrl || req.url, `${protocol}://${host}`);
+    const headers = new Headers();
+    for (const [k, v] of Object.entries(req.headers)) {
+        if (typeof v === 'string')
+            headers.set(k, v);
+        else if (Array.isArray(v))
+            headers.set(k, v.join(', '));
+    }
+    const body = req.body !== undefined ? JSON.stringify(req.body) : undefined;
+    return new Request(url, {
+        method: req.method,
+        headers,
+        body,
+    });
+}
+//# sourceMappingURL=createWalletServer.js.map

package/dist/createWalletServer.js.map

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

package/dist/dispatch.d.ts

@@ -0,0 +1,21 @@
+import type { JsonRpcResponse, MakeWalletLogger, ResolvedIdentity, WalletStorageProvider } from './types';
+export interface DispatchContext {
+    storage: WalletStorageProvider;
+    adminIdentityKeys?: string[];
+    makeLogger?: MakeWalletLogger;
+}
+export interface DispatchInput {
+    method: string;
+    params: unknown[];
+    id: string | number | null;
+    identity: ResolvedIdentity;
+}
+/**
+ * Methods that grow persisted wallet state. The accounts middleware uses this
+ * to decide whether a request is subject to metering. All other methods
+ * (reads, sync, shrink) stay free.
+ */
+export declare const BILLABLE_METHODS: ReadonlySet<string>;
+export declare function isBillableMethod(method: string): boolean;
+export declare function dispatch(ctx: DispatchContext, input: DispatchInput): Promise<JsonRpcResponse>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAEhB,qBAAqB,EACrB,MAAM,SAAS,CAAA;AAEhB,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,qBAAqB,CAAA;IAC9B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,UAAU,CAAC,EAAE,gBAAgB,CAAA;CAC7B;AAED,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,EAAE,gBAAgB,CAAA;CAC1B;AAMD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAM/C,CAAA;AAEF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAsB,QAAQ,CAC7B,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE,aAAa,GAClB,OAAO,CAAC,eAAe,CAAC,CAoC1B"}

package/dist/dispatch.js

@@ -0,0 +1,183 @@
+import { WERR_UNAUTHORIZED } from '@bsv/wallet-toolbox/out/src/sdk/WERR_errors.js';
+import { WalletError } from '@bsv/wallet-toolbox/out/src/sdk/WalletError.js';
+const METHODS_NO_AUTH = new Set(['getSettings']);
+const METHODS_IGNORED = new Set(['destroy']);
+const METHODS_ADMIN = new Set(['adminStats']);
+/**
+ * Methods that grow persisted wallet state. The accounts middleware uses this
+ * to decide whether a request is subject to metering. All other methods
+ * (reads, sync, shrink) stay free.
+ */
+export const BILLABLE_METHODS = new Set([
+    'createAction',
+    'processAction',
+    'internalizeAction',
+    'insertCertificateAuth',
+    'processSyncChunk',
+]);
+export function isBillableMethod(method) {
+    return BILLABLE_METHODS.has(method);
+}
+export async function dispatch(ctx, input) {
+    const { method, id } = input;
+    const storage = ctx.storage;
+    if (typeof storage[method] !== 'function') {
+        return methodNotFound(method, id);
+    }
+    if (METHODS_IGNORED.has(method)) {
+        return { jsonrpc: '2.0', result: undefined, id };
+    }
+    try {
+        const preparedParams = await prepareParams(ctx, input);
+        const logger = attachLoggerIfRequested(ctx, method, input.identity, preparedParams);
+        try {
+            const result = await storage[method](...preparedParams);
+            attachLoggerTail(logger, result);
+            return { jsonrpc: '2.0', result, id };
+        }
+        catch (err) {
+            logger?.flush?.();
+            throw err;
+        }
+    }
+    catch (err) {
+        return marshalError(err, id);
+    }
+}
+async function prepareParams(ctx, input) {
+    const { method, identity } = input;
+    const params = [...input.params];
+    if (METHODS_NO_AUTH.has(method)) {
+        return params;
+    }
+    if (method === 'findOrInsertUser') {
+        if (params[0] !== identity.identityKey) {
+            throw new WERR_UNAUTHORIZED('function may only access authenticated user.');
+        }
+        return params;
+    }
+    if (METHODS_ADMIN.has(method)) {
+        const arg0 = params[0];
+        if (!arg0 || arg0.identityKey !== identity.identityKey) {
+            throw new WERR_UNAUTHORIZED('function may only access authenticated admin user.');
+        }
+        if (!ctx.adminIdentityKeys?.includes(identity.identityKey)) {
+            throw new WERR_UNAUTHORIZED('function may only be accessed by admin user.');
+        }
+        return params;
+    }
+    await applyParam0Auth(ctx, identity, params);
+    if (method === 'processSyncChunk' && params[1]) {
+        normalizeSyncChunk(params[1]);
+    }
+    return params;
+}
+async function applyParam0Auth(ctx, identity, params) {
+    if (typeof params[0] !== 'object' || params[0] === null) {
+        params[0] = {};
+    }
+    const arg0 = params[0];
+    if (arg0.identityKey && arg0.identityKey !== identity.identityKey) {
+        throw new WERR_UNAUTHORIZED('identityKey does not match authentication');
+    }
+    const { user } = await ctx.storage.findOrInsertUser(identity.identityKey);
+    arg0.reqAuthUserId = user.userId;
+    if (arg0.identityKey) {
+        arg0.userId = user.userId;
+    }
+}
+function normalizeSyncChunk(chunk) {
+    const arrayFields = [
+        'certificateFields',
+        'certificates',
+        'commissions',
+        'outputBaskets',
+        'outputTagMaps',
+        'outputTags',
+        'outputs',
+        'provenTxReqs',
+        'provenTxs',
+        'transactions',
+        'txLabelMaps',
+        'txLabels',
+    ];
+    for (const field of arrayFields) {
+        const arr = chunk[field];
+        if (Array.isArray(arr)) {
+            for (let i = 0; i < arr.length; i++) {
+                arr[i] = validateEntity(arr[i]);
+            }
+        }
+    }
+    if (chunk.user && typeof chunk.user === 'object') {
+        chunk.user = validateEntity(chunk.user);
+    }
+}
+function validateEntity(entity) {
+    if ('created_at' in entity)
+        entity.created_at = validateDate(entity.created_at);
+    if ('updated_at' in entity)
+        entity.updated_at = validateDate(entity.updated_at);
+    for (const key of Object.keys(entity)) {
+        const val = entity[key];
+        if (val === null) {
+            entity[key] = undefined;
+        }
+        else if (isBuffer(val)) {
+            entity[key] = Array.from(val);
+        }
+    }
+    return entity;
+}
+function validateDate(date) {
+    return date instanceof Date ? date : new Date(date);
+}
+function isBuffer(val) {
+    if (val == null || typeof val !== 'object')
+        return false;
+    const buf = globalThis
+        .Buffer;
+    return typeof buf?.isBuffer === 'function' && buf.isBuffer(val);
+}
+function attachLoggerIfRequested(ctx, method, identity, params) {
+    if (!ctx.makeLogger)
+        return undefined;
+    const arg1 = params[1];
+    if (typeof arg1 !== 'object' || arg1 === null)
+        return undefined;
+    const logger = ctx.makeLogger(arg1.logger);
+    arg1.logger = logger;
+    logger.group?.(`wallet-server ${method}`);
+    if (identity.userId)
+        logger.log?.(`userId: ${identity.userId}`);
+    logger.log?.(`identityKey: ${identity.identityKey}`);
+    return logger;
+}
+function attachLoggerTail(logger, result) {
+    if (!logger)
+        return;
+    logger.groupEnd?.();
+    logger.flush?.();
+    if (logger.isOrigin)
+        return;
+    if (logger.logs && typeof result === 'object' && result !== null) {
+        ;
+        result.log = { logs: logger.logs };
+    }
+}
+function methodNotFound(method, id) {
+    return {
+        jsonrpc: '2.0',
+        error: { code: -32601, message: `Method not found: ${method}` },
+        id,
+    };
+}
+function marshalError(err, id) {
+    const json = WalletError.unknownToJson(err);
+    return {
+        jsonrpc: '2.0',
+        error: JSON.parse(json),
+        id,
+    };
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/dispatch.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { createWalletRpcHandler } from './createWalletRpcHandler';
+export type { WalletRpcHandler } from './createWalletRpcHandler';
+export { createBearerServer } from './createBearerServer';
+export type { BearerServerConfig, BearerServerHandle, } from './createBearerServer';
+export { createWalletServer } from './createWalletServer';
+export type { WalletServerConfig, WalletServerHandle, } from './createWalletServer';
+export { createWalletMonitor } from './createWalletMonitor';
+export type { WalletMonitorConfig, WalletMonitorHandle, } from './createWalletMonitor';
+export { BILLABLE_METHODS, dispatch, isBillableMethod } from './dispatch';
+export type { DispatchContext, DispatchInput } from './dispatch';
+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';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,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"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { createWalletRpcHandler } from './createWalletRpcHandler';
+export { createBearerServer } from './createBearerServer';
+export { createWalletServer } from './createWalletServer';
+export { createWalletMonitor } from './createWalletMonitor';
+export { BILLABLE_METHODS, dispatch, isBillableMethod } from './dispatch';
+export * from './resolvers';
+export * from './accounts';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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,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"}

package/dist/resolvers/bearer.d.ts

@@ -0,0 +1,12 @@
+import type { IdentityResolver } from '../types';
+export interface BearerResolverConfig {
+    /** Shared secret the caller must present. */
+    token: string;
+    /** Header name carrying the authenticated identity pubkey. Defaults to `X-Identity-Key`. */
+    identityHeader?: string;
+}
+export declare function bearerResolver(config: BearerResolverConfig): IdentityResolver;
+export declare class BearerAuthError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=bearer.d.ts.map

package/dist/resolvers/bearer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bearer.d.ts","sourceRoot":"","sources":["../../src/resolvers/bearer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAEhD,MAAM,WAAW,oBAAoB;IACpC,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAA;IACb,4FAA4F;IAC5F,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,gBAAgB,CA4B7E;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI3B"}

package/dist/resolvers/bearer.js

@@ -0,0 +1,43 @@
+export function bearerResolver(config) {
+    if (!config.token) {
+        throw new Error('bearerResolver requires a non-empty token');
+    }
+    const identityHeader = (config.identityHeader ?? 'X-Identity-Key').toLowerCase();
+    return async (req) => {
+        const auth = req.headers.get('authorization') ?? '';
+        const [scheme, value] = auth.split(/\s+/, 2);
+        if (scheme?.toLowerCase() !== 'bearer' || !value) {
+            throw new BearerAuthError('missing bearer token');
+        }
+        if (!timingSafeEqual(value, config.token)) {
+            throw new BearerAuthError('invalid bearer token');
+        }
+        const identityKey = req.headers.get(identityHeader);
+        if (!identityKey) {
+            throw new BearerAuthError(`missing ${identityHeader} header`);
+        }
+        if (!isHexPubKey(identityKey)) {
+            throw new BearerAuthError(`invalid ${identityHeader} header`);
+        }
+        return { identityKey };
+    };
+}
+export class BearerAuthError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'BearerAuthError';
+    }
+}
+function isHexPubKey(value) {
+    return /^[0-9a-fA-F]{66}$/.test(value);
+}
+function timingSafeEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    let diff = 0;
+    for (let i = 0; i < a.length; i++) {
+        diff |= a.charCodeAt(i) ^ b.charCodeAt(i);
+    }
+    return diff === 0;
+}
+//# sourceMappingURL=bearer.js.map

package/dist/resolvers/bearer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bearer.js","sourceRoot":"","sources":["../../src/resolvers/bearer.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,cAAc,CAAC,MAA4B;IAC1D,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;IAC7D,CAAC;IACD,MAAM,cAAc,GAAG,CACtB,MAAM,CAAC,cAAc,IAAI,gBAAgB,CACzC,CAAC,WAAW,EAAE,CAAA;IAEf,OAAO,KAAK,EAAE,GAAY,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAA;QACnD,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QAC5C,IAAI,MAAM,EAAE,WAAW,EAAE,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;YAClD,MAAM,IAAI,eAAe,CAAC,sBAAsB,CAAC,CAAA;QAClD,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,eAAe,CAAC,sBAAsB,CAAC,CAAA;QAClD,CAAC;QAED,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QACnD,IAAI,CAAC,WAAW,EAAE,CAAC;YAClB,MAAM,IAAI,eAAe,CAAC,WAAW,cAAc,SAAS,CAAC,CAAA;QAC9D,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,eAAe,CAAC,WAAW,cAAc,SAAS,CAAC,CAAA;QAC9D,CAAC;QAED,OAAO,EAAE,WAAW,EAAE,CAAA;IACvB,CAAC,CAAA;AACF,CAAC;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACzC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC9B,CAAC;CACD;AAED,SAAS,WAAW,CAAC,KAAa;IACjC,OAAO,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AACvC,CAAC;AAED,SAAS,eAAe,CAAC,CAAS,EAAE,CAAS;IAC5C,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IACvC,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IAC1C,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,CAAA;AAClB,CAAC"}

package/dist/resolvers/index.d.ts

@@ -0,0 +1,3 @@
+export { bearerResolver, BearerAuthError } from './bearer';
+export type { BearerResolverConfig } from './bearer';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resolvers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA"}

package/dist/resolvers/index.js

@@ -0,0 +1,2 @@
+export { bearerResolver, BearerAuthError } from './bearer';
+//# sourceMappingURL=index.js.map

package/dist/resolvers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resolvers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,52 @@
+import type { MakeWalletLogger, WalletLoggerInterface } from '@bsv/sdk';
+import type { sdk as walletSdk } from '@bsv/wallet-toolbox';
+export type WalletStorageProvider = walletSdk.WalletStorageProvider;
+export interface ResolvedIdentity {
+    identityKey: string;
+    userId?: number;
+}
+export type IdentityResolver = (req: Request) => Promise<ResolvedIdentity>;
+export interface PreDispatchContext {
+    method: string;
+    identity: ResolvedIdentity;
+    request: Request;
+    id: string | number | null;
+}
+export type PreDispatchResult = {
+    type: 'allow';
+} | {
+    type: 'blocked';
+    response: Response;
+};
+export type PreDispatchHook = (ctx: PreDispatchContext) => Promise<PreDispatchResult>;
+export interface WalletRpcHandlerConfig {
+    storage: WalletStorageProvider;
+    resolveIdentity: IdentityResolver;
+    adminIdentityKeys?: string[];
+    makeLogger?: MakeWalletLogger;
+    /** Optional gate that runs after identity resolution and before dispatch. */
+    preDispatch?: PreDispatchHook;
+}
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    method: string;
+    params?: unknown[];
+    id?: string | number | null;
+}
+export interface JsonRpcResponseOk {
+    jsonrpc: '2.0';
+    result: unknown;
+    id: string | number | null;
+}
+export interface JsonRpcResponseErr {
+    jsonrpc: '2.0';
+    error: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+    id: string | number | null;
+}
+export type JsonRpcResponse = JsonRpcResponseOk | JsonRpcResponseErr;
+export type { MakeWalletLogger, WalletLoggerInterface };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AACvE,OAAO,KAAK,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAE3D,MAAM,MAAM,qBAAqB,GAAG,SAAS,CAAC,qBAAqB,CAAA;AAEnE,MAAM,WAAW,gBAAgB;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAE1E,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,MAAM,iBAAiB,GAC1B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAA;AAE1C,MAAM,MAAM,eAAe,GAAG,CAC7B,GAAG,EAAE,kBAAkB,KACnB,OAAO,CAAC,iBAAiB,CAAC,CAAA;AAE/B,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,qBAAqB,CAAA;IAC9B,eAAe,EAAE,gBAAgB,CAAA;IACjC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,eAAe,CAAA;CAC7B;AAED,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,KAAK,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;IAClB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,KAAK,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,KAAK,CAAA;IACd,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACxD,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,kBAAkB,CAAA;AAEpE,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+	"name": "@1sat/wallet-server",
+	"version": "0.0.1",
+	"description": "BRC-100 wallet storage RPC server for 1Sat Ordinals SDK",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": ["dist"],
+	"scripts": {
+		"build": "tsc",
+		"dev": "tsc --watch",
+		"clean": "rm -rf dist",
+		"test": "bun test"
+	},
+	"keywords": ["1sat", "bsv", "ordinals", "wallet", "server", "rpc", "brc-100"],
+	"license": "MIT",
+	"dependencies": {
+		"@1sat/client": "0.0.21",
+		"@1sat/wallet": "0.0.47",
+		"express": "^4.21.2"
+	},
+	"peerDependencies": {
+		"@bsv/auth-express-middleware": "^2.0.4",
+		"@bsv/sdk": "^2.0.13",
+		"@bsv/wallet-toolbox": "^2.1.21",
+		"knex": "^3.1.0"
+	},
+	"peerDependenciesMeta": {
+		"pg": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@bsv/auth-express-middleware": "^2.0.4",
+		"@bsv/sdk": "^2.0.13",
+		"@bsv/wallet-toolbox": "^2.1.21",
+		"@types/bun": "^1.3.10",
+		"@types/express": "^4.17.21",
+		"knex": "^3.1.0",
+		"typescript": "^5.9.3"
+	}
+}