wowok 2.1.39 → 2.1.41

package/dist/esm/w/call/base.js

@@ -1,324 +1 @@
-// Copyright (c) Wowok.
-// SPDX-License-Identifier: Apache-2.0
-import { getFullnodeUrl, SuiClient } from "../../client/index.js";
-import { Transaction } from "../../transactions/index.js";
-import { isValidWowAddress } from "../../utils/sui-types.js";
-import { isValidU64, toTxObject } from "../common.js";
-import { W_ERROR, WErrors } from "../exception.js";
-import _ from "lodash";
-// eslint-disable-next-line import/no-cycle
-import { Account } from "../local/account.js";
-import { LocalMark } from "../local/local.js";
-import { query_objects, queryTableItem_PermissionPerm, queryTableItem_EntityRegistrar, raw2type, } from "../query/object.js";
-import { destroy, freeze, get_guardSubmissions, guardAdd, newPassport, verify, } from "./passport.js";
-import { addObjectTags, TagName, create as createResource, } from "./resource.js";
-import { register_with_resource_forced } from "./entity.js";
-import { getCallEnvAccount, resolveCallEnv } from "./util.js";
-import { Config } from "../local/config.js";
-export function isCallResultSubmission(result) {
-    return (result?.submission && result?.submission?.length > 0);
-}
-export function ResponseData(response) {
-    //console.dir(response, { depth: null, colors: true });
-    if (response?.digest) {
-        const res = [];
-        response?.objectChanges?.forEach((v) => {
-            const type_raw = v?.objectType;
-            const type = raw2type(type_raw);
-            if (type) {
-                res.push({
-                    type: type,
-                    type_raw: type_raw,
-                    object: v?.objectId,
-                    version: v?.version,
-                    owner: v?.owner,
-                    change: v.type,
-                });
-            }
-        });
-        return res;
-    }
-    return [];
-}
-export class CallBase {
-    // operation implementation for a call
-    newResource;
-    traceMarkNew = new Map();
-    content = undefined;
-    env_ready = false;
-    async operate(_env, _tx, _passport, _submission) { }
-    async prepare(env) {
-        await this.env_prepare(env);
-    }
-    // return WitnessFill to resolve filling witness, and than 'call_with_witness' to complete the call;
-    // return ResponseData when the call has completed;
-    // throw an exception when errors.
-    async call(_env) {
-        return undefined;
-    }
-    async env_prepare(env) {
-        if (this.env_ready) {
-            return;
-        }
-        await resolveCallEnv(env);
-        this.env_ready = true;
-    }
-    async call_with_submission(env, info, freezePassport) {
-        if (info.guard.length > 0) {
-            await this.prepare(env); // NOTE: prepare some
-            await this.check_passport(env, info, freezePassport);
-        }
-        return undefined;
-    }
-    async check_guard_and_call(env, guards_needed) {
-        env.permission_guard?.forEach((guard) => {
-            if (!isValidWowAddress(guard)) {
-                W_ERROR(WErrors.IsValidAddress, `env permission_guard: ${guard}`);
-            }
-            guards_needed.push(guard);
-        });
-        // check submissions
-        if (guards_needed.length > 0) {
-            const param = await get_guardSubmissions(env, guards_needed);
-            if (param.submission.length > 0) {
-                return {
-                    type: "submission",
-                    guard: param.guard,
-                    submission: param.submission,
-                };
-            }
-            // check passport
-            return await this.check_passport(env, param);
-        }
-        else {
-            return await this.exec(env);
-        }
-    }
-    async check_permission_and_call(env, permission, permIndex, guards_needed, checkOwner, checkAdmin) {
-        let bAdmin = false;
-        const p = await query_objects({
-            objects: [permission],
-            no_cache: env.no_cache,
-            network: env.network,
-        });
-        if (!p.objects?.[0] || p.objects?.[0].type !== "Permission") {
-            W_ERROR(WErrors.NoPermission, "permission object not found");
-        }
-        const perm_object = p.objects?.[0];
-        const acc = await getCallEnvAccount(env);
-        bAdmin = perm_object.admin.includes(acc);
-        //@ notice: builder
-        if (checkOwner && perm_object.builder !== acc)
-            W_ERROR(WErrors.NoPermission, `${acc} owner permission required`);
-        if (checkAdmin && !bAdmin)
-            W_ERROR(WErrors.NoPermission, `${acc} admin permission required`);
-        env.permission_guard?.forEach((guard) => {
-            if (!isValidWowAddress(guard)) {
-                W_ERROR(WErrors.IsValidAddress, `env permission_guard ${guard}`);
-            }
-            guards_needed.push(guard);
-        });
-        if (permIndex.length > 0 && !bAdmin) {
-            // Check both env.guard (if exists) and env.account
-            const addressesToCheck = [acc, ...(env.permission_guard ?? [])];
-            // Use Promise.all to query permissions in parallel
-            const permissionPromises = addressesToCheck.map(async (address) => {
-                const p = await queryTableItem_PermissionPerm({
-                    parent: permission,
-                    address: address,
-                    no_cache: env.no_cache,
-                    network: env.network,
-                });
-                if (p && p.type === "TableItem_PermissionPerm") {
-                    const perm = p;
-                    /*console.log(
-                        `PermissionPerm: ${address} -> ${perm.perm.join(", ")}`,
-                    );*/
-                    return { address, permissions: perm.perm };
-                }
-                return { address, permissions: [] };
-            });
-            const permissionResults = await Promise.all(permissionPromises);
-            // Collect all available permissions from all addresses
-            const allAvailablePermissions = new Set();
-            permissionResults.forEach((result) => {
-                result.permissions.forEach((perm) => allAvailablePermissions.add(perm));
-            });
-            // Check if all required permissions are available from any address
-            const missingPermissions = permIndex.filter((perm) => !allAvailablePermissions.has(perm));
-            if (missingPermissions.length > 0) {
-                // If we reach here, some permissions are missing from all addresses
-                W_ERROR(WErrors.NoPermission, `Missing permissions ${missingPermissions.join(", ")} in ${permission}`);
-            }
-        }
-        // check submissions
-        //console.log(`guards_needed: ${guards_needed.join(", ")}`);
-        if (guards_needed.length > 0) {
-            const param = await get_guardSubmissions(env, guards_needed);
-            //console.dir(param, { depth: null, colors: true });
-            if (param.submission.length > 0) {
-                return {
-                    type: "submission",
-                    guard: param.guard,
-                    submission: param.submission,
-                };
-            }
-            // check passport
-            return await this.check_passport(env, param);
-        }
-        else {
-            return await this.exec(env);
-        }
-    }
-    async check_passport(env, param, freezePassport) {
-        //console.dir(param, { depth: null, colors: true });
-        const tx = new Transaction();
-        const passport = newPassport(tx);
-        for (const v of param.guard) {
-            await guardAdd(tx, passport, v.object, param.submission.find((i) => i.guard === v.object)
-                ?.submission ?? [], v.impack);
-        }
-        verify(tx, passport);
-        await this.operate(env, tx, passport, param.submission);
-        if (freezePassport) {
-            freeze(tx, passport);
-        }
-        else {
-            destroy(tx, passport);
-        }
-        return await this.sign_and_commit(env, tx);
-    }
-    async exec(env) {
-        const tx = new Transaction();
-        await this.operate(env, tx);
-        return await this.sign_and_commit(env, tx);
-    }
-    async new_with_mark(env, tx, type, object, named_new, innerTags = [TagName.Launch]) {
-        const tags = named_new?.tags
-            ? _.uniq([...named_new.tags, ...innerTags])
-            : _.uniq([...innerTags]);
-        if (named_new) {
-            named_new.tags = tags;
-            this.traceMarkNew.set(type, named_new);
-        }
-        if (!named_new?.onChain)
-            return;
-        // onchain mark
-        if (!this.newResource) {
-            let r;
-            try {
-                r = await queryTableItem_EntityRegistrar({
-                    address: await getCallEnvAccount(env),
-                    no_cache: env.no_cache,
-                    network: env.network,
-                });
-            }
-            catch (e) {
-                // "error":{"code":"dynamicFieldNotFound",
-                //console.log(`queryTableItem_Entity failed: ${e}`);
-            }
-            if (r && r.type !== "TableItem_EntityRegistrar") {
-                W_ERROR(WErrors.NoPermission, "no entity registrar found");
-            }
-            // DONT change this.newResource
-            if (r?.mark_object) {
-                addObjectTags(tx, r.mark_object, {
-                    address: object,
-                    tags,
-                });
-                return; // return
-            }
-            else {
-                // 前面的逻辑已转换为string，故只用判断是否为string
-                this.newResource = register_with_resource_forced(tx, typeof env.referrer === "string" ? env.referrer : null);
-            }
-        }
-        if (this.newResource) {
-            addObjectTags(tx, this.newResource, {
-                address: object,
-                tags,
-            });
-        }
-    }
-    async update_content(env, type, object) {
-        if (this.content || !object)
-            return;
-        const r = await query_objects({
-            objects: [object],
-            no_cache: env.no_cache,
-            network: env.network,
-        });
-        if (!r.objects ||
-            r?.objects?.length !== 1 ||
-            r?.objects[0]?.type !== type) {
-            W_ERROR(WErrors.Fail, `Fetch ${type} object ${object} failed`);
-        }
-        this.content = r?.objects[0];
-    }
-    async sign_and_commit(env, tx) {
-        if (this.newResource) {
-            createResource(tx, this.newResource); //@ resource launch, if created.
-            this.newResource = undefined;
-        }
-        let r = await Account.Instance().sign_and_commit(tx, await getCallEnvAccount(env), env.network);
-        if (!r) {
-            W_ERROR(WErrors.Fail, "sign and commit failed");
-        }
-        if (r?.digest && !r?.objectChanges) {
-            const client = new SuiClient({
-                url: getFullnodeUrl(await Config.Instance().network_get(env.network)),
-            });
-            r = await client.getTransactionBlock({
-                digest: r?.digest,
-                options: { showObjectChanges: true },
-            });
-        }
-        // save the mark locally, anyway
-        const res = ResponseData(r);
-        for (let i = 0; i < res.length; ++i) {
-            const v = res[i];
-            if (v.type && v.change === "created") {
-                const namedNew = this.traceMarkNew.get(v.type);
-                if (namedNew) {
-                    await LocalMark.Instance().put([
-                        {
-                            name: namedNew.name
-                                ? {
-                                    value: namedNew.name,
-                                    replaceExistName: namedNew.replaceExistName,
-                                }
-                                : undefined,
-                            address: v.object,
-                            tags: namedNew?.tags
-                                ? [...namedNew.tags, v.type]
-                                : [v.type],
-                        },
-                    ]);
-                }
-            }
-        }
-        return r;
-    }
-}
-export async function getCoinParam(env, tx, coin, coinType) {
-    let coinParam;
-    if ("balance" in coin && coin.balance != null) {
-        if (!isValidU64(coin.balance)) {
-            W_ERROR(WErrors.IsValidU64, `Total pay balance ${coin.balance} is not valid`);
-        }
-        coinParam = await Account.Instance().get_coin_object(tx, coin.balance, coinType, await getCallEnvAccount(env), env.network);
-    }
-    else if ("coin" in coin && coin.coin != null) {
-        if (typeof coin.coin === "string") {
-            coinParam = await LocalMark.Instance().get_address(coin.coin);
-        }
-        else {
-            coinParam = coin.coin;
-        }
-    }
-    if (!coinParam) {
-        W_ERROR(WErrors.InvalidParam, `Total pay ${JSON.stringify(coin)} is allocated failed`);
-    }
-    return toTxObject(tx, coinParam);
-}
-//# sourceMappingURL=base.js.map
+import{getFullnodeUrl,SuiClient}from'../../client/index.js';import{Transaction}from'../../transactions/index.js';import{isValidWowAddress}from'../../utils/sui-types.js';import{isValidU64,toTxObject}from'../common.js';import{W_ERROR,WErrors}from'../exception.js';import a146a from'lodash';import{Account}from'../local/account.js';import{LocalMark}from'../local/local.js';import{query_objects,queryTableItem_PermissionPerm,queryTableItem_EntityRegistrar,raw2type}from'../query/object.js';import{destroy,freeze,get_guardSubmissions,guardAdd,newPassport,verify}from'./passport.js';import{addObjectTags,TagName,create as a146b}from'./resource.js';import{register_with_resource_forced}from'./entity.js';import{getCallEnvAccount,resolveCallEnv}from'./util.js';import{Config}from'../local/config.js';export function isCallResultSubmission(a){return a?.['submission']&&a?.['submission']?.['length']>0x0;}export function ResponseData(a){if(a?.['digest']){const b=[];return a?.['objectChanges']?.['forEach'](c=>{const d=c?.['objectType'],e=raw2type(d);e&&b['push']({'type':e,'type_raw':d,'object':c?.['objectId'],'version':c?.['version'],'owner':c?.['owner'],'change':c['type']});}),b;}return[];}export class CallBase{['newResource'];['traceMarkNew']=new Map();['content']=undefined;['env_ready']=![];async['operate'](a,b,c,d){}async['prepare'](a){await this['env_prepare'](a);}async['call'](a){return undefined;}async['env_prepare'](a){if(this['env_ready'])return;await resolveCallEnv(a),this['env_ready']=!![];}async['call_with_submission'](a,b,c){return b['guard']['length']>0x0&&(await this['prepare'](a),await this['check_passport'](a,b,c)),undefined;}async['check_guard_and_call'](a,b){a['permission_guard']?.['forEach'](c=>{!isValidWowAddress(c)&&W_ERROR(WErrors['IsValidAddress'],'env\x20permission_guard:\x20'+c),b['push'](c);});if(b['length']>0x0){const c=await get_guardSubmissions(a,b);if(c['submission']['length']>0x0)return{'type':'submission','guard':c['guard'],'submission':c['submission']};return await this['check_passport'](a,c);}else return await this['exec'](a);}async['check_permission_and_call'](a,b,c,d,e,f){let g=![];const h=await query_objects({'objects':[b],'no_cache':a['no_cache'],'network':a['network']});(!h['objects']?.[0x0]||h['objects']?.[0x0]['type']!=='Permission')&&W_ERROR(WErrors['NoPermission'],'permission\x20object\x20not\x20found');const i=h['objects']?.[0x0],j=await getCallEnvAccount(a);g=i['admin']['includes'](j);if(e&&i['builder']!==j)W_ERROR(WErrors['NoPermission'],j+'\x20owner\x20permission\x20required');if(f&&!g)W_ERROR(WErrors['NoPermission'],j+'\x20admin\x20permission\x20required');a['permission_guard']?.['forEach'](k=>{!isValidWowAddress(k)&&W_ERROR(WErrors['IsValidAddress'],'env\x20permission_guard\x20'+k),d['push'](k);});if(c['length']>0x0&&!g){const k=[j,...a['permission_guard']??[]],l=k['map'](async q=>{const r=await queryTableItem_PermissionPerm({'parent':b,'address':q,'no_cache':a['no_cache'],'network':a['network']});if(r&&r['type']==='TableItem_PermissionPerm'){const s=r;return{'address':q,'permissions':s['perm']};}return{'address':q,'permissions':[]};}),m=await Promise['all'](l),n=new Set();m['forEach'](q=>{q['permissions']['forEach'](r=>n['add'](r));});const o=c['filter'](q=>!n['has'](q));o['length']>0x0&&W_ERROR(WErrors['NoPermission'],'Missing\x20permissions\x20'+o['join'](',\x20')+'\x20in\x20'+b);}if(d['length']>0x0){const q=await get_guardSubmissions(a,d);if(q['submission']['length']>0x0)return{'type':'submission','guard':q['guard'],'submission':q['submission']};return await this['check_passport'](a,q);}else return await this['exec'](a);}async['check_passport'](a,b,c){const d=new Transaction(),e=newPassport(d);for(const f of b['guard']){await guardAdd(d,e,f['object'],b['submission']['find'](g=>g['guard']===f['object'])?.['submission']??[],f['impack']);}return verify(d,e),await this['operate'](a,d,e,b['submission']),c?freeze(d,e):destroy(d,e),await this['sign_and_commit'](a,d);}async['exec'](a){const b=new Transaction();return await this['operate'](a,b),await this['sign_and_commit'](a,b);}async['new_with_mark'](a,b,c,d,f,g=[TagName['Launch']]){const h=f?.['tags']?a146a['uniq']([...f['tags'],...g]):a146a['uniq']([...g]);f&&(f['tags']=h,this['traceMarkNew']['set'](c,f));if(!f?.['onChain'])return;if(!this['newResource']){let i;try{i=await queryTableItem_EntityRegistrar({'address':await getCallEnvAccount(a),'no_cache':a['no_cache'],'network':a['network']});}catch(j){}i&&i['type']!=='TableItem_EntityRegistrar'&&W_ERROR(WErrors['NoPermission'],'no\x20entity\x20registrar\x20found');if(i?.['mark_object']){addObjectTags(b,i['mark_object'],{'address':d,'tags':h});return;}else this['newResource']=register_with_resource_forced(b,typeof a['referrer']==='string'?a['referrer']:null);}this['newResource']&&addObjectTags(b,this['newResource'],{'address':d,'tags':h});}async['update_content'](a,b,c){if(this['content']||!c)return;const d=await query_objects({'objects':[c],'no_cache':a['no_cache'],'network':a['network']});(!d['objects']||d?.['objects']?.['length']!==0x1||d?.['objects'][0x0]?.['type']!==b)&&W_ERROR(WErrors['Fail'],'Fetch\x20'+b+'\x20object\x20'+c+'\x20failed'),this['content']=d?.['objects'][0x0];}async['sign_and_commit'](a,b){this['newResource']&&(a146b(b,this['newResource']),this['newResource']=undefined);let c=await Account['Instance']()['sign_and_commit'](b,await getCallEnvAccount(a),a['network']);!c&&W_ERROR(WErrors['Fail'],'sign\x20and\x20commit\x20failed');if(c?.['digest']&&!c?.['objectChanges']){const e=new SuiClient({'url':getFullnodeUrl(await Config['Instance']()['network_get'](a['network']))});c=await e['getTransactionBlock']({'digest':c?.['digest'],'options':{'showObjectChanges':!![]}});}const d=ResponseData(c);for(let f=0x0;f<d['length'];++f){const g=d[f];if(g['type']&&g['change']==='created'){const h=this['traceMarkNew']['get'](g['type']);h&&await LocalMark['Instance']()['put']([{'name':h['name']?{'value':h['name'],'replaceExistName':h['replaceExistName']}:undefined,'address':g['object'],'tags':h?.['tags']?[...h['tags'],g['type']]:[g['type']]}]);}}return c;}}export async function getCoinParam(a,b,c,d){let e;if('balance'in c&&c['balance']!=null)!isValidU64(c['balance'])&&W_ERROR(WErrors['IsValidU64'],'Total\x20pay\x20balance\x20'+c['balance']+'\x20is\x20not\x20valid'),e=await Account['Instance']()['get_coin_object'](b,c['balance'],d,await getCallEnvAccount(a),a['network']);else'coin'in c&&c['coin']!=null&&(typeof c['coin']==='string'?e=await LocalMark['Instance']()['get_address'](c['coin']):e=c['coin']);return!e&&W_ERROR(WErrors['InvalidParam'],'Total\x20pay\x20'+JSON['stringify'](c)+'\x20is\x20allocated\x20failed'),toTxObject(b,e);}