@bsv/wallet-toolbox-client 2.4.3 → 2.4.20

package/out/src/WalletPermissionsManager.d.ts

@@ -1,981 +0,0 @@
-import { WalletInterface, WalletProtocol, Base64String, PubKeyHex } from '@bsv/sdk';
-/** Line item type for spending authorization requests. */
-export type LineItemType = 'input' | 'output' | 'fee';
-/** Security level for DPACP protocol permissions. */
-export type SecurityLevel = 0 | 1 | 2;
-/**
- * A permissions module handles request/response transformation for a specific P-protocol or P-basket scheme under BRC-98/99.
- * Modules are registered in the config mapped by their scheme ID.
- */
-export interface PermissionsModule {
-    /**
-     * Transforms the request before it's passed to the underlying wallet.
-     * Can check and enforce permissions, throw errors, or modify any arguments as needed prior to invocation.
-     *
-     * @param req - The incoming request with method, args, and originator
-     * @returns Transformed arguments that will be passed to the underlying wallet
-     */
-    onRequest: (req: {
-        method: string;
-        args: object;
-        originator: string;
-    }) => Promise<{
-        args: object;
-    }>;
-    /**
-     * Transforms the response from the underlying wallet before returning to caller.
-     *
-     * @param res - The response from the underlying wallet
-     * @param context - Metadata about the original request (method, originator)
-     * @returns Transformed response to return to the caller
-     */
-    onResponse: (res: any, context: {
-        method: string;
-        originator: string;
-    }) => Promise<any>;
-}
-/**
- * Describes a group of permissions that can be requested together.
- * This structure is based on BRC-73.
- */
-export interface GroupedPermissions {
-    description?: string;
-    spendingAuthorization?: {
-        amount: number;
-        description: string;
-    };
-    protocolPermissions?: Array<{
-        protocolID: WalletProtocol;
-        counterparty?: string;
-        description: string;
-    }>;
-    basketAccess?: Array<{
-        basket: string;
-        description: string;
-    }>;
-    certificateAccess?: Array<{
-        type: string;
-        fields: string[];
-        verifierPublicKey: string;
-        description: string;
-    }>;
-}
-/**
- * The object passed to the UI when a grouped permission is requested.
- */
-export interface GroupedPermissionRequest {
-    originator: string;
-    requestID: string;
-    permissions: GroupedPermissions;
-}
-/**
- * Signature for functions that handle a grouped permission request event.
- */
-export type GroupedPermissionEventHandler = (request: GroupedPermissionRequest) => void | Promise<void>;
-export interface CounterpartyPermissions {
-    description?: string;
-    protocols: Array<{
-        protocolName: string;
-        protocolID?: WalletProtocol;
-        description?: string;
-    }>;
-}
-export interface CounterpartyPermissionRequest {
-    originator: string;
-    requestID: string;
-    counterparty: PubKeyHex;
-    counterpartyLabel?: string;
-    permissions: CounterpartyPermissions;
-}
-export type CounterpartyPermissionEventHandler = (request: CounterpartyPermissionRequest) => void | Promise<void>;
-/**
- * Describes a single requested permission that the user must either grant or deny.
- *
- * Four categories of permission are supported, each with a unique protocol:
- *  1) protocol - "DPACP" (Domain Protocol Access Control Protocol)
- *  2) basket   - "DBAP"  (Domain Basket Access Protocol)
- *  3) certificate - "DCAP" (Domain Certificate Access Protocol)
- *  4) spending - "DSAP"  (Domain Spending Authorization Protocol)
- *
- * This model underpins "requests" made to the user for permission, which the user can
- * either grant or deny. The manager can then create on-chain tokens (PushDrop outputs)
- * if permission is granted. Denying requests cause the underlying operation to throw,
- * and no token is created. An "ephemeral" grant is also possible, denoting a one-time
- * authorization without an associated persistent on-chain token.
- */
-export interface PermissionRequest {
-    type: 'protocol' | 'basket' | 'certificate' | 'spending';
-    originator: string;
-    displayOriginator?: string;
-    usageType?: string;
-    privileged?: boolean;
-    protocolID?: WalletProtocol;
-    counterparty?: string;
-    basket?: string;
-    certificate?: {
-        verifier: string;
-        certType: string;
-        fields: string[];
-    };
-    spending?: {
-        satoshis: number;
-        lineItems?: Array<{
-            type: LineItemType;
-            description: string;
-            satoshis: number;
-        }>;
-    };
-    reason?: string;
-    renewal?: boolean;
-    previousToken?: PermissionToken;
-}
-/**
- * Signature for functions that handle a permission request event, e.g. "Please ask the user to allow basket X".
- */
-export type PermissionEventHandler = (request: PermissionRequest & {
-    requestID: string;
-}) => void | Promise<void>;
-/**
- * Data structure representing an on-chain permission token.
- * It is typically stored as a single unspent PushDrop output in a special "internal" admin basket belonging to
- * the user, held in their underlying wallet.
- *
- * It can represent any of the four permission categories by having the relevant fields:
- *  - DPACP: originator, privileged, protocol, securityLevel, counterparty
- *  - DBAP:  originator, basketName
- *  - DCAP:  originator, privileged, verifier, certType, certFields
- *  - DSAP:  originator, authorizedAmount
- */
-export interface PermissionToken {
-    /** The transaction ID where this token resides. */
-    txid: string;
-    /** The current transaction encapsulating the token. */
-    tx: number[];
-    /** The output index within that transaction. */
-    outputIndex: number;
-    /** The exact script hex for the locking script. */
-    outputScript: string;
-    /** The amount of satoshis assigned to the permission output (often 1). */
-    satoshis: number;
-    /** The originator domain or FQDN that is allowed to use this permission. */
-    originator: string;
-    /**
-     * The raw, unnormalized originator string captured at the time the permission
-     * token was created. This is preserved so we can continue to recognize legacy
-     * permissions that were stored with different casing or explicit default ports.
-     */
-    rawOriginator?: string;
-    /** The expiration time for this token in UNIX epoch seconds. (0 or omitted for spending authorizations, which are indefinite) */
-    expiry: number;
-    /** Whether this token grants privileged usage (for protocol or certificate). */
-    privileged?: boolean;
-    /** The protocol name, if this is a DPACP token. */
-    protocol?: string;
-    /** The security level (0,1,2) for DPACP. */
-    securityLevel?: SecurityLevel;
-    /** The counterparty, for DPACP. */
-    counterparty?: string;
-    /** The name of a basket, if this is a DBAP token. */
-    basketName?: string;
-    /** The certificate type, if this is a DCAP token. */
-    certType?: string;
-    /** The certificate fields that this token covers, if DCAP token. */
-    certFields?: string[];
-    /** The "verifier" public key string, if DCAP. */
-    verifier?: string;
-    /** For DSAP, the maximum authorized spending for the month. */
-    authorizedAmount?: number;
-}
-/**
- * The set of callbacks that external code can bind to, e.g. to display UI prompts or logs
- * when a permission is requested.
- */
-export interface WalletPermissionsManagerCallbacks {
-    onProtocolPermissionRequested?: PermissionEventHandler[];
-    onBasketAccessRequested?: PermissionEventHandler[];
-    onCertificateAccessRequested?: PermissionEventHandler[];
-    onSpendingAuthorizationRequested?: PermissionEventHandler[];
-    onGroupedPermissionRequested?: GroupedPermissionEventHandler[];
-    onCounterpartyPermissionRequested?: CounterpartyPermissionEventHandler[];
-}
-/**
- * Configuration object for the WalletPermissionsManager. If a given option is `false`,
- * the manager will skip or alter certain permission checks or behaviors.
- *
- * By default, all of these are `true` unless specified otherwise. This is the most secure configuration.
- */
-export interface PermissionsManagerConfig {
-    /**
-     * A map of P-basket/protocol permission scheme modules.
-     *
-     * Keys are scheme IDs (e.g., "btms"), values are PermissionsModule instances.
-     *
-     * Each module handles basket/protocol names of the form: `p <schemeID> <rest...>`
-     *
-     * The WalletPermissionManager detects P-prefix baskets/protocols and delegates
-     * request/response transformation to the corresponding module.
-     *
-     * If no module exists for a given schemeID, the wallet will reject access.
-     */
-    permissionModules?: Record<string, PermissionsModule>;
-    /**
-     * For `createSignature` and `verifySignature`,
-     * require a "protocol usage" permission check?
-     */
-    seekProtocolPermissionsForSigning?: boolean;
-    /**
-     * For methods that perform encryption (encrypt/decrypt), require
-     * a "protocol usage" permission check?
-     */
-    seekProtocolPermissionsForEncrypting?: boolean;
-    /**
-     * For methods that perform HMAC creation or verification (createHmac, verifyHmac),
-     * require a "protocol usage" permission check?
-     */
-    seekProtocolPermissionsForHMAC?: boolean;
-    /**
-     * For revealing counterparty-level or specific key linkage revelation information,
-     * should we require permission?
-     */
-    seekPermissionsForKeyLinkageRevelation?: boolean;
-    /**
-     * For revealing any user public key (getPublicKey) **other** than the identity key,
-     * should we require permission?
-     */
-    seekPermissionsForPublicKeyRevelation?: boolean;
-    /**
-     * If getPublicKey is requested with `identityKey=true`, do we require permission?
-     */
-    seekPermissionsForIdentityKeyRevelation?: boolean;
-    /**
-     * If discoverByIdentityKey / discoverByAttributes are called, do we require permission
-     * for "identity resolution" usage?
-     */
-    seekPermissionsForIdentityResolution?: boolean;
-    /**
-     * When we do internalizeAction with `basket insertion`, or include outputs in baskets
-     * with `createAction, do we ask for basket permission?
-     */
-    seekBasketInsertionPermissions?: boolean;
-    /**
-     * When relinquishOutput is called, do we ask for basket permission?
-     */
-    seekBasketRemovalPermissions?: boolean;
-    /**
-     * When listOutputs is called, do we ask for basket permission?
-     */
-    seekBasketListingPermissions?: boolean;
-    /**
-     * When createAction is called with labels, do we ask for "label usage" permission?
-     */
-    seekPermissionWhenApplyingActionLabels?: boolean;
-    /**
-     * When listActions is called with labels, do we ask for "label usage" permission?
-     */
-    seekPermissionWhenListingActionsByLabel?: boolean;
-    /**
-     * If proving a certificate (proveCertificate) or revealing certificate fields,
-     * do we require a "certificate access" permission?
-     */
-    seekCertificateDisclosurePermissions?: boolean;
-    /**
-     * If acquiring a certificate (acquireCertificate), do we require a permission check?
-     */
-    seekCertificateAcquisitionPermissions?: boolean;
-    /**
-     * If relinquishing a certificate (relinquishCertificate), do we require a permission check?
-     */
-    seekCertificateRelinquishmentPermissions?: boolean;
-    /**
-     * If listing a user's certificates (listCertificates), do we require a permission check?
-     */
-    seekCertificateListingPermissions?: boolean;
-    /**
-     * Should transaction descriptions, input descriptions, and output descriptions be encrypted
-     * when before they are passed to the underlying wallet, and transparently decrypted when retrieved?
-     */
-    encryptWalletMetadata?: boolean;
-    /**
-     * If the originator tries to spend wallet funds (netSpent > 0 in createAction),
-     * do we seek spending authorization?
-     */
-    seekSpendingPermissions?: boolean;
-    /**
-     * If true, triggers a grouped permission request flow based on the originator's `manifest.json`.
-     */
-    seekGroupedPermission?: boolean;
-    /**
-     * If false, permissions are checked without regard for whether we are in
-     * privileged mode. Privileged status is ignored with respect to whether
-     * permissions are granted. Internally, they are always sought and checked
-     * with privileged=false, regardless of the actual value.
-     */
-    differentiatePrivilegedOperations?: boolean;
-    /**
-     * An allowlist mapping counterparty identity public keys (hex)
-     * to protocol names that are automatically permitted
-     * without prompting the user.
-     */
-    whitelistedCounterparties?: {
-        [counterparty: PubKeyHex]: string[];
-    };
-}
-/**
- * @class WalletPermissionsManager
- *
- * Wraps an underlying BRC-100 `Wallet` implementation with permissions management capabilities.
- * The manager intercepts calls from external applications (identified by originators), checks if the request is allowed,
- * and if not, orchestrates user permission flows. It creates or renews on-chain tokens in special
- * admin baskets to track these authorizations. Finally, it proxies the actual call to the underlying wallet.
- *
- * ### Key Responsibilities:
- *  - **Permission Checking**: Before standard wallet operations (e.g. `encrypt`),
- *    the manager checks if a valid permission token exists. If not, it attempts to request permission from the user.
- *  - **On-Chain Tokens**: When permission is granted, the manager stores it as an unspent "PushDrop" output.
- *    This can be spent later to revoke or renew the permission.
- *  - **Callbacks**: The manager triggers user-defined callbacks on permission requests (to show a UI prompt),
- *    on grants/denials, and on internal processes.
- *
- * ### Implementation Notes:
- *  - The manager follows the BRC-100 `createAction` + `signAction` pattern for building or spending these tokens.
- *  - Token revocation or renewal uses standard BRC-100 flows: we build a transaction that consumes
- *    the old token UTXO and outputs a new one (or none, if fully revoked).
- */
-export declare class WalletPermissionsManager implements WalletInterface {
-    /** A reference to the BRC-100 wallet instance. */
-    private readonly underlying;
-    /** The "admin" domain or FQDN that is implicitly allowed to do everything. */
-    private readonly adminOriginator;
-    /**
-     * Event callbacks that external code can subscribe to, e.g. to show a UI prompt
-     * or log events. Each event can have multiple handlers.
-     */
-    private readonly callbacks;
-    /**
-     * We queue parallel requests for the same resource so that only one
-     * user prompt is created for a single resource. If multiple calls come
-     * in at once for the same "protocol:domain:privileged:counterparty" etc.,
-     * they get merged.
-     *
-     * The key is a string derived from the operation; the value is an object with a reference to the
-     * associated request and an array of pending promise resolve/reject pairs, one for each active
-     * operation that's waiting on the particular resource described by the key.
-     */
-    private readonly activeRequests;
-    /** Cache recently confirmed permissions to avoid repeated lookups. */
-    private readonly permissionCache;
-    private readonly recentGrants;
-    /**
-     * Token mints currently being written on-chain, keyed by permission cache
-     * key. A granted permission is only cached once its token finishes minting
-     * (network seconds); ensures arriving in that window await the in-flight
-     * mint instead of re-prompting the user for a permission they just granted.
-     * Stored promises never reject.
-     */
-    private readonly mintsInFlight;
-    private readonly manifestCache;
-    private readonly manifestFetchInProgress;
-    private static readonly MANIFEST_CACHE_TTL_MS;
-    private readonly groupedPermissionFlowTail;
-    private readonly pactEstablishedCache;
-    /**
-     * Parsed BEEF bundles keyed by the raw BEEF array of a `listOutputs`
-     * result, so token scans parse each bundle once instead of once per output.
-     * `null` records a bundle that failed to parse. WeakMap-keyed so entries
-     * are released with their results.
-     */
-    private readonly parsedBeefCache;
-    /** Counts token-field decrypts so long scans can periodically yield. */
-    private tokenFieldDecryptCount;
-    /** How long a cached permission remains valid (5 minutes). */
-    private static readonly CACHE_TTL_MS;
-    /** Window during which freshly granted permissions are auto-allowed (except spending). */
-    private static readonly RECENT_GRANT_COVER_MS;
-    /** Default ports used when normalizing originator values. */
-    private static readonly DEFAULT_PORTS;
-    /**
-     * Configuration that determines whether to skip or apply various checks and encryption.
-     */
-    private readonly config;
-    /**
-     * Constructs a new Permissions Manager instance.
-     *
-     * @param underlyingWallet           The underlying BRC-100 wallet, where requests are forwarded after permission is granted
-     * @param adminOriginator            The domain or FQDN that is automatically allowed everything
-     * @param config                     A set of boolean flags controlling how strictly permissions are enforced
-     */
-    constructor(underlyingWallet: WalletInterface, adminOriginator: string, config?: PermissionsManagerConfig);
-    /**
-     * Delegates a wallet method call to a P-module if the basket or protocol name uses a P-scheme.
-     * Handles the full request/response transformation flow.
-     *
-     * @param basketOrProtocolName - The basket or protocol name to check for p-module delegation
-     * @param method - The wallet method name being called
-     * @param args - The original args passed to the method
-     * @param originator - The originator of the request
-     * @param underlyingCall - Callback that executes the underlying wallet method with transformed args
-     * @returns The transformed response, or null if not a P-basket/protocol (caller should continue normal flow)
-     */
-    private delegateToPModuleIfNeeded;
-    /**
-     * Adds a permission module for the given schemeID if needed, throwing if unsupported.
-     */
-    private addPModuleByScheme;
-    /**
-     * Splits labels into P and non-P lists, registering any P-modules encountered.
-     *
-     * P-labels follow BRC-111 format: `p <moduleId> <payload>`
-     * - Must start with "p " (lowercase p + space)
-     * - Module ID must be at least 1 character with no spaces
-     * - Single space separates module ID from payload
-     * - Payload must be at least 1 character
-     *
-     * @example Valid: "p btms token123", "p invoicing invoice 2026-02-02"
-     * @example Invalid: "p btms" (no payload), "p btms " (empty payload), "p  data" (empty moduleId)
-     *
-     * @param labels - Array of label strings to process
-     * @param pModulesByScheme - Map to populate with discovered p-modules
-     * @returns Array of non-P labels for normal permission checks
-     * @throws Error if p-label format is invalid or module is unsupported
-     */
-    private splitLabelsByPermissionModule;
-    /**
-     * Decrypts custom instructions in listOutputs results if encryption is configured.
-     */
-    private decryptListOutputsMetadata;
-    /**
-     * Decrypts metadata in listActions results if encryption is configured.
-     */
-    private decryptListActionsMetadata;
-    private decryptSingleActionMetadata;
-    private decryptActionOutputMetadata;
-    /**
-     * Binds a callback function to a named event, such as `onProtocolPermissionRequested`.
-     *
-     * @param eventName The name of the event to listen to
-     * @param handler   A function that handles the event
-     * @returns         A numeric ID you can use to unbind later
-     */
-    bindCallback(eventName: keyof WalletPermissionsManagerCallbacks, handler: PermissionEventHandler | GroupedPermissionEventHandler | CounterpartyPermissionEventHandler): number;
-    /**
-     * Unbinds a previously registered callback by either its numeric ID (returned by `bindCallback`)
-     * or by exact function reference.
-     *
-     * @param eventName  The event name, e.g. "onProtocolPermissionRequested"
-     * @param reference  Either the numeric ID or the function reference
-     * @returns          True if successfully unbound, false otherwise
-     */
-    unbindCallback(eventName: keyof WalletPermissionsManagerCallbacks, reference: number | Function): boolean;
-    /**
-     * Internally triggers a named event, calling all subscribed listeners.
-     * Each callback is awaited in turn (though errors are swallowed so that
-     * one failing callback doesn't prevent the others).
-     *
-     * @param eventName The event name
-     * @param param     The parameter object passed to all listeners
-     */
-    private callEvent;
-    /**
-     * Grants a previously requested permission.
-     * This method:
-     *  1) Resolves all pending promise calls waiting on this request
-     *  2) Optionally creates or renews an on-chain PushDrop token (unless `ephemeral===true`)
-     *
-     * @param params      requestID to identify which request is granted, plus optional expiry
-     *                    or `ephemeral` usage, etc.
-     */
-    grantPermission(params: {
-        requestID: string;
-        expiry?: number;
-        ephemeral?: boolean;
-        amount?: number;
-    }): Promise<void>;
-    /**
-     * Denies a previously requested permission.
-     * This method rejects all pending promise calls waiting on that request
-     *
-     * @param requestID    requestID identifying which request to deny
-     */
-    denyPermission(requestID: string): Promise<void>;
-    /**
-     * Grants a previously requested grouped permission.
-     * @param params.requestID The ID of the request being granted.
-     * @param params.granted A subset of the originally requested permissions that the user has granted.
-     * @param params.expiry An optional expiry time (in seconds) for the new permission tokens.
-     */
-    grantGroupedPermission(params: {
-        requestID: string;
-        granted: Partial<GroupedPermissions>;
-        expiry?: number;
-    }): Promise<void>;
-    /**
-     * Denies a previously requested grouped permission.
-     * @param requestID The ID of the request being denied.
-     */
-    /**
-     * Validates that every entry in `granted` was part of the original `requested` set.
-     * Throws an error on the first mismatch.
-     */
-    private validateGrantedPermissionsSubset;
-    private denyActiveRequest;
-    denyGroupedPermission(requestID: string): Promise<void>;
-    dismissGroupedPermission(requestID: string): Promise<void>;
-    grantCounterpartyPermission(params: {
-        requestID: string;
-        granted: Partial<CounterpartyPermissions>;
-        expiry?: number;
-    }): Promise<void>;
-    denyCounterpartyPermission(requestID: string): Promise<void>;
-    /**
-     * Ensures the originator has protocol usage permission.
-     * If no valid (unexpired) permission token is found, triggers a permission request flow.
-     */
-    ensureProtocolPermission({ originator, privileged, protocolID, counterparty, reason, seekPermission, usageType }: {
-        originator: string;
-        privileged: boolean;
-        protocolID: WalletProtocol;
-        counterparty: string;
-        reason?: string;
-        seekPermission?: boolean;
-        usageType: 'signing' | 'encrypting' | 'hmac' | 'publicKey' | 'identityKey' | 'linkageRevelation' | 'generic';
-    }): Promise<boolean>;
-    /**
-     * Ensures the originator has basket usage permission for the specified basket.
-     * If not, triggers a permission request flow.
-     */
-    ensureBasketAccess({ originator, basket, reason, seekPermission, usageType }: {
-        originator: string;
-        basket: string;
-        reason?: string;
-        seekPermission?: boolean;
-        usageType: 'insertion' | 'removal' | 'listing';
-    }): Promise<boolean>;
-    /** Returns false when the basket usageType does NOT need a permission check (config-gated). */
-    private isBasketUsageRequired;
-    /**
-     * Ensures the originator has a valid certificate permission.
-     * This is relevant when revealing certificate fields in DCAP contexts.
-     */
-    ensureCertificateAccess({ originator, privileged, verifier, certType, fields, reason, seekPermission, usageType }: {
-        originator: string;
-        privileged: boolean;
-        verifier: string;
-        certType: string;
-        fields: string[];
-        reason?: string;
-        seekPermission?: boolean;
-        usageType: 'disclosure';
-    }): Promise<boolean>;
-    /**
-     * Ensures the originator has spending authorization (DSAP) for a certain satoshi amount.
-     * If the existing token limit is insufficient, attempts to renew. If no token, attempts to create one.
-     */
-    ensureSpendingAuthorization({ originator, satoshis, lineItems, reason, seekPermission }: {
-        originator: string;
-        satoshis: number;
-        lineItems?: Array<{
-            type: LineItemType;
-            description: string;
-            satoshis: number;
-        }>;
-        reason?: string;
-        seekPermission?: boolean;
-    }): Promise<boolean>;
-    /**
-     * Ensures the originator has label usage permission.
-     * If no valid (unexpired) permission token is found, triggers a permission request flow.
-     */
-    ensureLabelAccess({ originator, label, reason, seekPermission, usageType }: {
-        originator: string;
-        label: string;
-        reason?: string;
-        seekPermission?: boolean;
-        usageType: 'apply' | 'list';
-    }): Promise<boolean>;
-    /**
-     * Returns true when the given usageType is configured to skip permission checks.
-     */
-    private isProtocolUsageTypeExempted;
-    private isProtocolInCounterpartyPermissions;
-    private validateCounterpartyPermissions;
-    private fetchManifestPermissions;
-    private fetchManifestGroupPermissions;
-    private filterAlreadyGrantedPermissions;
-    private hasAnyPermissionsToRequest;
-    private hasGroupedPermissionRequestedHandlers;
-    private hasCounterpartyPermissionRequestedHandlers;
-    private hasPactEstablished;
-    private markPactEstablished;
-    private maybeRequestPact;
-    private joinOrCreatePactRequest;
-    private maybeRequestPeerGroupedLevel2ProtocolPermissions;
-    private withGroupedPermissionFlowLock;
-    private checkSpecificPermissionAfterGroupFlow;
-    private isRequestIncludedInGroupPermissions;
-    private maybeRequestGroupedPermissions;
-    /**
-     * Joins an existing grouped permission request (piggybacks on the existing promise), or creates
-     * a new one and fires the onGroupedPermissionRequested event.
-     */
-    private joinOrCreateGroupedRequest;
-    /**
-     * A central method that triggers the permission request flow.
-     * - It checks if there's already an active request for the same key
-     * - If so, we wait on that existing request rather than creating a duplicative one
-     * - Otherwise we create a new request queue, call the relevant "onXXXRequested" event,
-     *   and return a promise that resolves once permission is granted or rejects if denied.
-     */
-    private requestPermissionFlow;
-    /** Returns true when an active-request queue already has pending waiters for this key. */
-    private isPiggybacking;
-    /** Appends to an existing request queue and waits for resolution. */
-    private piggybackOnExistingQueue;
-    /** Runs the grouped-permission flow (with or without a lock) and checks post-group satisfaction. */
-    private resolveGroupedFlow;
-    /** Creates a new active-request queue entry, fires the event, and returns the promise. */
-    private enqueueAndFireEvent;
-    /** Fires the appropriate onXXXRequested event based on the request type. */
-    private firePermissionRequestEvent;
-    /**
-     * We will use a administrative "permission token encryption" protocol to store fields
-     * in each permission's PushDrop script. This ensures that only the user's wallet
-     * can decrypt them. In practice, this data is not super sensitive, but we still
-     * follow the principle of least exposure.
-     */
-    private static readonly PERM_TOKEN_ENCRYPTION_PROTOCOL;
-    /**
-     * Similarly, we will use a "metadata encryption" protocol to preserve the confidentiality
-     * of transaction descriptions and input/output descriptions from lower storage layers.
-     */
-    private static readonly METADATA_ENCRYPTION_PROTOCOL;
-    /** We always use `keyID="1"` and `counterparty="self"` for these encryption ops. */
-    private encryptPermissionTokenField;
-    /**
-     * Extracts a transaction from a `listOutputs` result's BEEF bundle, parsing
-     * the bundle only once per result. Calling
-     * `Transaction.fromBEEF(result.BEEF, txid)` per output re-parses the entire
-     * bundle every time — O(n²) in the number of outputs — which can block the
-     * caller's thread (in browser wallets, the UI) for seconds on large
-     * permission baskets.
-     */
-    private transactionFromResultBeef;
-    private decryptPermissionTokenField;
-    /**
-     * Encrypts wallet metadata if configured to do so, otherwise returns the original plaintext for storage.
-     * @param plaintext The metadata to encrypt if configured to do so
-     * @returns The encrypted metadata, or the original value if encryption was disabled.
-     */
-    private maybeEncryptMetadata;
-    /**
-     * Attempts to decrypt metadata. if decryption fails, assumes the value is already plaintext and returns it.
-     * @param ciphertext The metadata to attempt decryption for.
-     * @returns The decrypted metadata. If decryption fails, returns the original value instead.
-     */
-    private maybeDecryptMetadata;
-    /** Helper to see if a token's expiry is in the past. */
-    private isTokenExpired;
-    /** Decrypts the standard 6 fields from a protocol (DPACP) PushDrop script. */
-    private decryptProtocolTokenFields;
-    /** Parses outpoint string "txid.vout" into [txid, outputIndex]. */
-    private parseOutpoint;
-    /** Normalizes a txid string to lowercase. */
-    private normalizeTxid;
-    /** Reverses a 32-byte hex txid (for endian normalization). */
-    private reverseHexTxid;
-    /**
-     * Returns true when an outpoint string (e.g. "txid.vout" or "txid:vout") refers to `token`.
-     */
-    private tokenMatchesOutpointString;
-    /**
-     * Finds the index of the tx input that spends the given permission token.
-     * Handles multiple potential field names for TXID and vout.
-     */
-    private findInputIndexForToken;
-    /** Looks for a DPACP permission token matching origin/domain, privileged, protocol, cpty. */
-    private findProtocolToken;
-    /** Finds ALL DPACP permission tokens matching origin/domain, privileged, protocol, cpty. Never filters by expiry. */
-    private findAllProtocolTokens;
-    /** Looks for a DBAP token matching (originator, basket). */
-    private findBasketToken;
-    /** Looks for a DCAP token matching (origin, privileged, verifier, certType, fields subset). */
-    private findCertificateToken;
-    /** Looks for a DSAP token matching origin, returning the first one found. */
-    private findSpendingToken;
-    /**
-     * Returns the current month and year in UTC as a string in the format "YYYY-MM".
-     *
-     * @returns {string} The current month and year in UTC.
-     */
-    private getCurrentMonthYearUTC;
-    /**
-     * Returns spending for an originator in the current calendar month.
-     */
-    querySpentSince(token: PermissionToken): Promise<number>;
-    /**
-     * Creates a brand-new permission token as a single-output PushDrop script in the relevant admin basket.
-     *
-     * The main difference between each type of token is in the "fields" we store in the PushDrop script.
-     *
-     * @param r        The permission request
-     * @param expiry   The expiry epoch time
-     * @param amount   For DSAP, the authorized spending limit
-     */
-    private createPermissionOnChain;
-    private mapWithConcurrency;
-    private runBestEffortBatches;
-    private runBestEffortChunk;
-    private buildPermissionOutput;
-    private createPermissionTokensBestEffort;
-    private renewPermissionTokensBestEffort;
-    private coalescePermissionTokens;
-    /**
-     * Renews a permission token by spending the old token as input and creating a new token output.
-     * This invalidates the old token and replaces it with a new one.
-     *
-     * @param oldToken The old token to consume
-     * @param r        The permission request being renewed
-     * @param newExpiry The new expiry epoch time
-     * @param newAmount For DSAP, the new authorized amount
-     */
-    private renewPermissionOnChain;
-    /**
-     * Builds the encrypted array of fields for a PushDrop permission token
-     * (protocol / basket / certificate / spending).
-     */
-    private buildPushdropFields;
-    /**
-     * Helper to build an array of tags for the new output, matching the user request's
-     * origin, basket, privileged, protocol name, etc.
-     */
-    private buildTagsForRequest;
-    /**
-     * Lists all protocol permission tokens (DPACP) with optional filters.
-     * @param originator Optional originator domain to filter by
-     * @param privileged Optional boolean to filter by privileged status
-     * @param protocolName Optional protocol name to filter by
-     * @param protocolSecurityLevel Optional protocol security level to filter by
-     * @param counterparty Optional counterparty to filter by
-     * @returns Array of permission tokens that match the filter criteria
-     */
-    listProtocolPermissions({ originator, privileged, protocolName, protocolSecurityLevel, counterparty }?: {
-        originator?: string;
-        privileged?: boolean;
-        protocolName?: string;
-        protocolSecurityLevel?: number;
-        counterparty?: string;
-    }): Promise<PermissionToken[]>;
-    /** Builds the base tag array for protocol permission listing. */
-    private buildProtocolFilterTags;
-    /** Decodes and appends protocol permission tokens from a listOutputs result. */
-    private collectProtocolTokens;
-    /**
-     * Returns true if the originator already holds a valid unexpired protocol permission.
-     * This calls `ensureProtocolPermission` with `seekPermission=false`, so it won't prompt.
-     */
-    hasProtocolPermission(params: {
-        originator: string;
-        privileged: boolean;
-        protocolID: WalletProtocol;
-        counterparty: string;
-    }): Promise<boolean>;
-    /**
-     * Lists basket permission tokens (DBAP) for a given originator or basket (or for all if not specified).
-     * @param params.originator Optional originator to filter by
-     * @param params.basket Optional basket name to filter by
-     * @returns Array of permission tokens that match the filter criteria
-     */
-    listBasketAccess(params?: {
-        originator?: string;
-        basket?: string;
-    }): Promise<PermissionToken[]>;
-    /**
-     * Returns `true` if the originator already holds a valid unexpired basket permission for `basket`.
-     */
-    hasBasketAccess(params: {
-        originator: string;
-        basket: string;
-    }): Promise<boolean>;
-    /**
-     * Lists spending authorization tokens (DSAP) for a given originator (or all).
-     */
-    listSpendingAuthorizations(params: {
-        originator?: string;
-    }): Promise<PermissionToken[]>;
-    /**
-     * Returns `true` if the originator already holds a valid spending authorization token
-     * with enough available monthly spend. We do not prompt (seekPermission=false).
-     */
-    hasSpendingAuthorization(params: {
-        originator: string;
-        satoshis: number;
-    }): Promise<boolean>;
-    /**
-     * Lists certificate permission tokens (DCAP) with optional filters.
-     * @param originator Optional originator domain to filter by
-     * @param privileged Optional boolean to filter by privileged status
-     * @param certType Optional certificate type to filter by
-     * @param verifier Optional verifier to filter by
-     * @returns Array of permission tokens that match the filter criteria
-     */
-    listCertificateAccess(params?: {
-        originator?: string;
-        privileged?: boolean;
-        certType?: Base64String;
-        verifier?: PubKeyHex;
-    }): Promise<PermissionToken[]>;
-    /** Decodes and appends certificate permission tokens from a listOutputs result. */
-    private collectCertificateTokens;
-    /**
-     * Returns `true` if the originator already holds a valid unexpired certificate access
-     * for the given certType/fields. Does not prompt the user.
-     */
-    hasCertificateAccess(params: {
-        originator: string;
-        privileged: boolean;
-        verifier: string;
-        certType: string;
-        fields: string[];
-    }): Promise<boolean>;
-    revokePermissions(oldTokens: PermissionToken[]): Promise<PermissionToken[]>;
-    revokeAllForOriginator(originator: string, opts?: {
-        protocol?: boolean;
-        basket?: boolean;
-        certificate?: boolean;
-        spending?: boolean;
-    }): Promise<PermissionToken[]>;
-    private revokePermissionTokensBestEffort;
-    private revokePermissionTokensChunk;
-    /**
-     * Revokes a permission token by spending it with no replacement output.
-     * The manager builds a BRC-100 transaction that consumes the token, effectively invalidating it.
-     */
-    revokePermission(oldToken: PermissionToken): Promise<void>;
-    createAction(args: Parameters<WalletInterface['createAction']>[0], originator?: string): ReturnType<WalletInterface['createAction']>;
-    /** Scans outputs to split P-scheme baskets from regular baskets; registers P-modules as a side effect. */
-    private collectNonPBaskets;
-    /** Enforces signAndProcess=false for non-admin originators; throws if admin override is missing. */
-    private enforceSignAndProcess;
-    /** Encrypts all description/instruction fields in args in-place; returns original (plaintext) copies. */
-    private encryptActionMetadata;
-    /** Calls underlying createAction, chaining P-module request/response transforms when needed. */
-    private callCreateActionWithPModules;
-    /**
-     * Computes the net satoshis the originator is spending in a createAction call,
-     * accounting for foreign (originator-provided) inputs and outputs plus the fee.
-     * Also builds the line items list for the spending authorization request.
-     */
-    /**
-     * Defense-in-depth verification that each caller-requested output (locking
-     * script + amount) is present in the transaction returned for signing.
-     *
-     * The scripts in the signable transaction originate from storage. A malicious
-     * or compromised remote storage provider could substitute a different
-     * recipient script for a caller-specified output. The signer
-     * (buildSignableTransaction) rejects this at the source; this is an
-     * independent check at the permissions layer so the substitution is caught
-     * regardless of how the signable transaction was produced.
-     *
-     * Outputs are matched as a multiset on (lockingScript, satoshis): the
-     * transaction also contains change/commission outputs and the output order is
-     * randomized by default, and a caller may legitimately request the same
-     * script+amount more than once.
-     *
-     * @throws Error if any caller-requested output is absent from the transaction.
-     */
-    private verifyRequestedOutputsPresent;
-    private computeNetSpend;
-    signAction(...args: Parameters<WalletInterface['signAction']>): ReturnType<WalletInterface['signAction']>;
-    abortAction(...args: Parameters<WalletInterface['abortAction']>): ReturnType<WalletInterface['abortAction']>;
-    listActions(...args: Parameters<WalletInterface['listActions']>): ReturnType<WalletInterface['listActions']>;
-    internalizeAction(...args: Parameters<WalletInterface['internalizeAction']>): ReturnType<WalletInterface['internalizeAction']>;
-    listOutputs(...args: Parameters<WalletInterface['listOutputs']>): ReturnType<WalletInterface['listOutputs']>;
-    relinquishOutput(...args: Parameters<WalletInterface['relinquishOutput']>): ReturnType<WalletInterface['relinquishOutput']>;
-    getPublicKey(...args: Parameters<WalletInterface['getPublicKey']>): ReturnType<WalletInterface['getPublicKey']>;
-    revealCounterpartyKeyLinkage(...args: Parameters<WalletInterface['revealCounterpartyKeyLinkage']>): ReturnType<WalletInterface['revealCounterpartyKeyLinkage']>;
-    revealSpecificKeyLinkage(...args: Parameters<WalletInterface['revealSpecificKeyLinkage']>): ReturnType<WalletInterface['revealSpecificKeyLinkage']>;
-    encrypt(...args: Parameters<WalletInterface['encrypt']>): ReturnType<WalletInterface['encrypt']>;
-    decrypt(...args: Parameters<WalletInterface['decrypt']>): ReturnType<WalletInterface['decrypt']>;
-    createHmac(...args: Parameters<WalletInterface['createHmac']>): ReturnType<WalletInterface['createHmac']>;
-    verifyHmac(...args: Parameters<WalletInterface['verifyHmac']>): ReturnType<WalletInterface['verifyHmac']>;
-    createSignature(...args: Parameters<WalletInterface['createSignature']>): ReturnType<WalletInterface['createSignature']>;
-    verifySignature(...args: Parameters<WalletInterface['verifySignature']>): ReturnType<WalletInterface['verifySignature']>;
-    acquireCertificate(...args: Parameters<WalletInterface['acquireCertificate']>): ReturnType<WalletInterface['acquireCertificate']>;
-    listCertificates(...args: Parameters<WalletInterface['listCertificates']>): ReturnType<WalletInterface['listCertificates']>;
-    proveCertificate(...args: Parameters<WalletInterface['proveCertificate']>): ReturnType<WalletInterface['proveCertificate']>;
-    relinquishCertificate(...args: Parameters<WalletInterface['relinquishCertificate']>): ReturnType<WalletInterface['relinquishCertificate']>;
-    discoverByIdentityKey(...args: Parameters<WalletInterface['discoverByIdentityKey']>): ReturnType<WalletInterface['discoverByIdentityKey']>;
-    discoverByAttributes(...args: Parameters<WalletInterface['discoverByAttributes']>): ReturnType<WalletInterface['discoverByAttributes']>;
-    isAuthenticated(...args: Parameters<WalletInterface['isAuthenticated']>): ReturnType<WalletInterface['isAuthenticated']>;
-    waitForAuthentication(...args: Parameters<WalletInterface['waitForAuthentication']>): ReturnType<WalletInterface['waitForAuthentication']>;
-    getHeight(...args: Parameters<WalletInterface['getHeight']>): ReturnType<WalletInterface['getHeight']>;
-    getHeaderForHeight(...args: Parameters<WalletInterface['getHeaderForHeight']>): ReturnType<WalletInterface['getHeaderForHeight']>;
-    getNetwork(...args: Parameters<WalletInterface['getNetwork']>): ReturnType<WalletInterface['getNetwork']>;
-    getVersion(...args: Parameters<WalletInterface['getVersion']>): ReturnType<WalletInterface['getVersion']>;
-    /** Returns true if the specified origin is the admin originator. */
-    private isAdminOriginator;
-    /**
-     * Checks if the given protocol is admin-reserved per BRC-100 rules:
-     *
-     *  - Must not start with `admin` (admin-reserved)
-     *  - Must not start with `p ` (allows for future specially permissioned protocols)
-     *
-     * If it violates these rules and the caller is not admin, we consider it "admin-only."
-     */
-    private isAdminProtocol;
-    /**
-     * Checks if the given label is admin-reserved per BRC-100 rules:
-     *
-     *  - Must not start with `admin` (admin-reserved)
-     *  - Must not start with `p ` (permissioned labels requiring a permission module)
-     *
-     * If it violates these rules and the caller is not admin, we consider it "admin-only."
-     */
-    private isAdminLabel;
-    /**
-     * Checks if the given basket is admin-reserved per BRC-100 rules:
-     *
-     *  - Must not start with `admin`
-     *  - Must not be `default` (some wallets use this for internal operations)
-     *  - Must not start with `p ` (future specially permissioned baskets)
-     */
-    private isAdminBasket;
-    /**
-     * Whether the permission is satisfied without consulting on-chain tokens:
-     * cached, recently granted, or — when the user just granted it and its
-     * token is still minting — after the in-flight mint settles. Spares the
-     * user a duplicate prompt for a grant they already made moments ago.
-     */
-    private hasRecentOrPendingGrant;
-    /**
-     * Returns true if we have a cached record that the permission identified by
-     * `key` is valid and unexpired.
-     */
-    private isPermissionCached;
-    /** Caches the fact that the permission for `key` is valid until `expiry`. */
-    private cachePermission;
-    /** Records that a non-spending permission was just granted so we can skip re-prompting briefly. */
-    private markRecentGrant;
-    /** Returns true if we are inside the short "cover window" immediately after granting permission. */
-    private isRecentlyGranted;
-    /** Normalizes and canonicalizes originator domains (e.g., lowercase + drop default ports). */
-    private normalizeOriginator;
-    private isWhitelistedCounterpartyProtocol;
-    /**
-     * Produces a normalized originator value along with the set of legacy
-     * representations that should be considered when searching for existing
-     * permission tokens (for backwards compatibility).
-     */
-    private prepareOriginator;
-    /**
-     * Builds a unique list of originator variants that should be searched when
-     * looking up on-chain tokens (e.g., legacy raw + normalized forms).
-     */
-    private buildOriginatorLookupValues;
-    /**
-     * Builds a "map key" string so that identical requests (e.g. "protocol:domain:true:protoName:counterparty")
-     * do not produce multiple user prompts.
-     */
-    private buildRequestKey;
-    private buildActiveRequestKey;
-}
-//# sourceMappingURL=WalletPermissionsManager.d.ts.map