@wowok/wowok 2.2.11

package/dist/esm/transactions/ObjectCache.d.ts

@@ -0,0 +1,83 @@
+import type { bcs } from "../bcs/index.js";
+import type { OpenMoveTypeSignature } from "./data/internal.js";
+import type { TransactionPlugin } from "./resolve.js";
+export interface ObjectCacheEntry {
+    objectId: string;
+    version: string;
+    digest: string;
+    owner: string | null;
+    initialSharedVersion: string | null;
+}
+export interface MoveFunctionCacheEntry {
+    package: string;
+    module: string;
+    function: string;
+    parameters: OpenMoveTypeSignature[];
+}
+export interface CacheEntryTypes {
+    OwnedObject: ObjectCacheEntry;
+    SharedOrImmutableObject: ObjectCacheEntry;
+    MoveFunction: MoveFunctionCacheEntry;
+    Custom: unknown;
+}
+export declare abstract class AsyncCache {
+    protected abstract get<T extends keyof CacheEntryTypes>(type: T, key: string): Promise<CacheEntryTypes[T] | null>;
+    protected abstract set<T extends keyof CacheEntryTypes>(type: T, key: string, value: CacheEntryTypes[T]): Promise<void>;
+    protected abstract delete<T extends keyof CacheEntryTypes>(type: T, key: string): Promise<void>;
+    abstract clear<T extends keyof CacheEntryTypes>(type?: T): Promise<void>;
+    getObject(id: string): Promise<ObjectCacheEntry>;
+    getObjects(ids: string[]): Promise<ObjectCacheEntry[]>;
+    addObject(object: ObjectCacheEntry): Promise<ObjectCacheEntry>;
+    addObjects(objects: ObjectCacheEntry[]): Promise<void>;
+    deleteObject(id: string): Promise<void>;
+    deleteObjects(ids: string[]): Promise<void>;
+    getMoveFunctionDefinition(ref: {
+        package: string;
+        module: string;
+        function: string;
+    }): Promise<MoveFunctionCacheEntry>;
+    addMoveFunctionDefinition(functionEntry: MoveFunctionCacheEntry): Promise<{
+        package: string;
+        module: string;
+        function: string;
+        parameters: OpenMoveTypeSignature[];
+    }>;
+    deleteMoveFunctionDefinition(ref: {
+        package: string;
+        module: string;
+        function: string;
+    }): Promise<void>;
+    getCustom<T>(key: string): Promise<T>;
+    setCustom<T>(key: string, value: T): Promise<void>;
+    deleteCustom(key: string): Promise<void>;
+}
+export declare class InMemoryCache extends AsyncCache {
+    #private;
+    protected get<T extends keyof CacheEntryTypes>(type: T, key: string): Promise<CacheEntryTypes[T]>;
+    protected set<T extends keyof CacheEntryTypes>(type: T, key: string, value: CacheEntryTypes[T]): Promise<void>;
+    protected delete<T extends keyof CacheEntryTypes>(type: T, key: string): Promise<void>;
+    clear<T extends keyof CacheEntryTypes>(type?: T): Promise<void>;
+}
+export interface ObjectCacheOptions {
+    cache?: AsyncCache;
+    onEffects?: (effects: typeof bcs.TransactionEffects.$inferType) => Promise<void>;
+}
+export declare class ObjectCache {
+    #private;
+    constructor({ cache, onEffects, }: ObjectCacheOptions);
+    asPlugin(): TransactionPlugin;
+    clear(): Promise<void>;
+    getMoveFunctionDefinition(ref: {
+        package: string;
+        module: string;
+        function: string;
+    }): Promise<MoveFunctionCacheEntry>;
+    getObjects(ids: string[]): Promise<ObjectCacheEntry[]>;
+    deleteObjects(ids: string[]): Promise<void>;
+    clearOwnedObjects(): Promise<void>;
+    clearCustom(): Promise<void>;
+    getCustom<T>(key: string): Promise<T>;
+    setCustom<T>(key: string, value: T): Promise<void>;
+    deleteCustom(key: string): Promise<void>;
+    applyEffects(effects: typeof bcs.TransactionEffects.$inferType): Promise<void>;
+}

package/dist/esm/transactions/ObjectCache.js

@@ -0,0 +1 @@
+import{normalizeWowAddress}from'../utils/wow-types.js';export class AsyncCache{async['getObject'](a){const [b,c]=await Promise['all']([this['get']('OwnedObject',a),this['get']('SharedOrImmutableObject',a)]);return b??c??null;}async['getObjects'](a){return Promise['all'](a['map'](b=>this['getObject'](b)));}async['addObject'](a){return a['owner']?await this['set']('OwnedObject',a['objectId'],a):await this['set']('SharedOrImmutableObject',a['objectId'],a),a;}async['addObjects'](a){await Promise['all'](a['map'](async b=>this['addObject'](b)));}async['deleteObject'](a){await Promise['all']([this['delete']('OwnedObject',a),this['delete']('SharedOrImmutableObject',a)]);}async['deleteObjects'](a){await Promise['all'](a['map'](b=>this['deleteObject'](b)));}async['getMoveFunctionDefinition'](a){const b=normalizeWowAddress(a['package'])+'::'+a['module']+'::'+a['function'];return this['get']('MoveFunction',b);}async['addMoveFunctionDefinition'](a){const b=normalizeWowAddress(a['package']),c=b+'::'+a['module']+'::'+a['function'],d={...a,'package':b};return await this['set']('MoveFunction',c,d),d;}async['deleteMoveFunctionDefinition'](a){const b=normalizeWowAddress(a['package'])+'::'+a['module']+'::'+a['function'];await this['delete']('MoveFunction',b);}async['getCustom'](a){return this['get']('Custom',a);}async['setCustom'](a,b){return this['set']('Custom',a,b);}async['deleteCustom'](a){return this['delete']('Custom',a);}}export class InMemoryCache extends AsyncCache{#caches={'OwnedObject':new Map(),'SharedOrImmutableObject':new Map(),'MoveFunction':new Map(),'Custom':new Map()};async['get'](a,b){return this.#caches[a]['get'](b)??null;}async['set'](a,b,c){this.#caches[a]['set'](b,c);}async['delete'](a,b){this.#caches[a]['delete'](b);}async['clear'](a){if(a)this.#caches[a]['clear']();else for(const b of Object['values'](this.#caches)){b['clear']();}}}export class ObjectCache{#cache;#onEffects;constructor({cache:cache=new InMemoryCache(),onEffects:a}){this.#cache=cache,this.#onEffects=a;}['asPlugin'](){return async(a,b,c)=>{const d=a['inputs']['filter'](g=>g['UnresolvedObject'])['map'](g=>g['UnresolvedObject']['objectId']),e=(await this.#cache['getObjects'](d))['filter'](g=>g!==null),f=new Map(e['map'](g=>[g['objectId'],g]));for(const g of a['inputs']){if(!g['UnresolvedObject'])continue;const h=f['get'](g['UnresolvedObject']['objectId']);if(!h)continue;h['initialSharedVersion']&&!g['UnresolvedObject']['initialSharedVersion']?g['UnresolvedObject']['initialSharedVersion']=h['initialSharedVersion']:(h['version']&&!g['UnresolvedObject']['version']&&(g['UnresolvedObject']['version']=h['version']),h['digest']&&!g['UnresolvedObject']['digest']&&(g['UnresolvedObject']['digest']=h['digest']));}await Promise['all'](a['commands']['map'](async i=>{if(i['MoveCall']){const j=await this['getMoveFunctionDefinition']({'package':i['MoveCall']['package'],'module':i['MoveCall']['module'],'function':i['MoveCall']['function']});j&&(i['MoveCall']['_argumentTypes']=j['parameters']);}})),await c(),await Promise['all'](a['commands']['map'](async i=>{i['MoveCall']?.['_argumentTypes']&&await this.#cache['addMoveFunctionDefinition']({'package':i['MoveCall']['package'],'module':i['MoveCall']['module'],'function':i['MoveCall']['function'],'parameters':i['MoveCall']['_argumentTypes']});}));};}async['clear'](){await this.#cache['clear']();}async['getMoveFunctionDefinition'](a){return this.#cache['getMoveFunctionDefinition'](a);}async['getObjects'](a){return this.#cache['getObjects'](a);}async['deleteObjects'](a){return this.#cache['deleteObjects'](a);}async['clearOwnedObjects'](){await this.#cache['clear']('OwnedObject');}async['clearCustom'](){await this.#cache['clear']('Custom');}async['getCustom'](a){return this.#cache['getCustom'](a);}async['setCustom'](a,b){return this.#cache['setCustom'](a,b);}async['deleteCustom'](a){return this.#cache['deleteCustom'](a);}async['applyEffects'](a){if(!a['V2'])throw new Error('Unsupported\x20transaction\x20effects\x20version\x20'+a['$kind']);const {lamportVersion:b,changedObjects:c}=a['V2'],d=[],e=[];c['forEach'](([f,g])=>{if(g['outputState']['NotExist'])d['push'](f);else{if(g['outputState']['ObjectWrite']){const [h,i]=g['outputState']['ObjectWrite'];e['push']({'objectId':f,'digest':h,'version':b,'owner':i['AddressOwner']??i['ObjectOwner']??null,'initialSharedVersion':i['Shared']?.['initialSharedVersion']??null});}}}),await Promise['all']([this.#cache['addObjects'](e),this.#cache['deleteObjects'](d),this.#onEffects?.(a)]);}}