UMP sync

client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bsv/wallet-toolbox-client",
-  "version": "1.7.12",
+  "version": "1.7.13",
   "description": "Client only Wallet Storage",
   "main": "./out/src/index.client.js",
   "types": "./out/src/index.client.d.ts",

docs/client.md

@@ -4004,17 +4004,16 @@ encryptWalletMetadata?: boolean
 
 ###### Property permissionModules
 
-A map of P-basket permission scheme modules.
+A map of P-basket/protocol permission scheme modules.
 
 Keys are scheme IDs (e.g., "btms"), values are PermissionsModule instances.
 
-Each module handles basket IDs of the form: `p <schemeID> <rest...>`
+Each module handles basket/protocol names of the form: `p <schemeID> <rest...>`
 
-The WalletPermissionManager detects P-prefix baskets and delegates
+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 MUST reject access
-according to the P-Baskets specification.
+If no module exists for a given schemeID, the wallet will reject access.
 
 ```ts
 permissionModules?: Record<string, PermissionsModule>
@@ -4179,19 +4178,17 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ---
 ##### Interface: PermissionsModule
 
-A permissions module handles request/response transformation for a specific P-basket scheme.
+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.
 
 ```ts
 export interface PermissionsModule {
     onRequest(req: {
         method: string;
-        args: any[];
+        args: object;
         originator: string;
     }): Promise<{
-        method: string;
-        args: any[];
-        originator: string;
+        args: object;
     }>;
     onResponse(res: any, context: {
         method: string;
@@ -4203,23 +4200,21 @@ export interface PermissionsModule {
 ###### Method onRequest
 
 Transforms the request before it's passed to the underlying wallet.
-Can modify method name, args, or originator as needed.
+Can check and enforce permissions, throw errors, or modify any arguments as needed prior to invocation.
 
 ```ts
 onRequest(req: {
     method: string;
-    args: any[];
+    args: object;
     originator: string;
 }): Promise<{
-    method: string;
-    args: any[];
-    originator: string;
+    args: object;
 }>
 ```
 
 Returns
 
-Transformed request that will be passed to the underlying wallet
+Transformed arguments that will be passed to the underlying wallet
 
 Argument Details
 
@@ -9000,6 +8995,7 @@ export class CWIStyleWalletManager implements WalletInterface {
     async provideRecoveryKey(recoveryKey: number[]): Promise<void> 
     saveSnapshot(): number[] 
     async loadSnapshot(snapshot: number[]): Promise<void> 
+    async syncUMPToken(): Promise<boolean> 
     destroy(): void 
     listProfiles(): Array<{
         id: number[];

docs/wallet.md

@@ -4003,17 +4003,16 @@ encryptWalletMetadata?: boolean
 
 ###### Property permissionModules
 
-A map of P-basket permission scheme modules.
+A map of P-basket/protocol permission scheme modules.
 
 Keys are scheme IDs (e.g., "btms"), values are PermissionsModule instances.
 
-Each module handles basket IDs of the form: `p <schemeID> <rest...>`
+Each module handles basket/protocol names of the form: `p <schemeID> <rest...>`
 
-The WalletPermissionManager detects P-prefix baskets and delegates
+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 MUST reject access
-according to the P-Baskets specification.
+If no module exists for a given schemeID, the wallet will reject access.
 
 ```ts
 permissionModules?: Record<string, PermissionsModule>
@@ -4178,19 +4177,17 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ---
 ##### Interface: PermissionsModule
 
-A permissions module handles request/response transformation for a specific P-basket scheme.
+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.
 
 ```ts
 export interface PermissionsModule {
     onRequest(req: {
         method: string;
-        args: any[];
+        args: object;
         originator: string;
     }): Promise<{
-        method: string;
-        args: any[];
-        originator: string;
+        args: object;
     }>;
     onResponse(res: any, context: {
         method: string;
@@ -4202,23 +4199,21 @@ export interface PermissionsModule {
 ###### Method onRequest
 
 Transforms the request before it's passed to the underlying wallet.
-Can modify method name, args, or originator as needed.
+Can check and enforce permissions, throw errors, or modify any arguments as needed prior to invocation.
 
 ```ts
 onRequest(req: {
     method: string;
-    args: any[];
+    args: object;
     originator: string;
 }): Promise<{
-    method: string;
-    args: any[];
-    originator: string;
+    args: object;
 }>
 ```
 
 Returns
 
-Transformed request that will be passed to the underlying wallet
+Transformed arguments that will be passed to the underlying wallet
 
 Argument Details
 
@@ -8999,6 +8994,7 @@ export class CWIStyleWalletManager implements WalletInterface {
     async provideRecoveryKey(recoveryKey: number[]): Promise<void> 
     saveSnapshot(): number[] 
     async loadSnapshot(snapshot: number[]): Promise<void> 
+    async syncUMPToken(): Promise<boolean> 
     destroy(): void 
     listProfiles(): Array<{
         id: number[];

mobile/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bsv/wallet-toolbox-mobile",
-  "version": "1.7.12",
+  "version": "1.7.13",
   "description": "Client only Wallet Storage",
   "main": "./out/src/index.mobile.js",
   "types": "./out/src/index.mobile.d.ts",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bsv/wallet-toolbox",
-  "version": "1.7.12",
+  "version": "1.7.13",
   "description": "BRC100 conforming wallet, wallet storage and wallet signer components",
   "main": "./out/src/index.js",
   "types": "./out/src/index.d.ts",

src/CWIStyleWalletManager.ts

@@ -1044,6 +1044,40 @@
     }
   }
 
+  async syncUMPToken(): Promise<boolean> {
+    if (!this.authenticated || !this.currentUMPToken || !this.rootPrimaryKey) {
+      throw new Error('Wallet not authenticated or missing UMP token.')
+    }
+
+    const currentToken = this.currentUMPToken
+    let refreshed: UMPToken | undefined
+
+    if (currentToken.presentationHash && currentToken.presentationHash.length) {
+      refreshed = await this.UMPTokenInteractor.findByPresentationKeyHash(currentToken.presentationHash)
+    }
+
+    if (!refreshed && currentToken.recoveryHash && currentToken.recoveryHash.length) {
+      refreshed = await this.UMPTokenInteractor.findByRecoveryKeyHash(currentToken.recoveryHash)
+    }
+
+    if (!refreshed) {
+      return false
+    }
+
+    if (
+      refreshed.currentOutpoint &&
+      currentToken.currentOutpoint &&
+      refreshed.currentOutpoint === currentToken.currentOutpoint
+    ) {
+      return false
+    }
+
+    this.currentUMPToken = refreshed
+    await this.setupRootInfrastructure(this.rootPrimaryKey)
+    this.saveSnapshot()
+    return true
+  }
+
   /**
    * Destroys the wallet state, clearing keys, tokens, and profiles.
    */