@rango-dev/wallets-core 0.62.1 → 0.62.2-next.1

package/dist/namespaces/tron/actions.d.ts

@@ -1,2 +1,20 @@
+import type { ProviderAPI, TronActions } from './types.js';
+import type { Context } from '../../hub/namespaces/mod.js';
+import type { FunctionWithContext } from '../../types/actions.js';
 export declare const recommended: (readonly ["disconnect", typeof import("../common/actions.js").disconnect])[];
+/**
+ * Reads a TRC-20 `allowance(owner, spender)` via a constant contract call and
+ * returns it as a decimal string.
+ */
+export declare function getAllowance(instance: () => ProviderAPI | undefined): FunctionWithContext<TronActions['getAllowance'], Context>;
+/**
+ * Builds (via the node) a ready-to-sign `approve(spender, amount)` transaction
+ * on the TRC-20 token contract.
+ *
+ * The transaction carries TronWeb's default 60s expiration, which is the same
+ * window server-built approvals use.
+ */
+export declare function buildApproveTransaction(instance: () => ProviderAPI | undefined): FunctionWithContext<TronActions['buildApproveTransaction'], Context>;
+/** Reads a transaction's on-chain info (empty while the tx is unconfirmed). */
+export declare function getTransactionInfo(instance: () => ProviderAPI | undefined): FunctionWithContext<TronActions['getTransactionInfo'], Context>;
 //# sourceMappingURL=actions.d.ts.map

package/dist/namespaces/tron/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/namespaces/tron/actions.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,+EAAyB,CAAC"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/namespaces/tron/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAclE,eAAO,MAAM,WAAW,+EAAyB,CAAC;AAElD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,WAAW,GAAG,SAAS,GACtC,mBAAmB,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,CAyB3D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,WAAW,GAAG,SAAS,GACtC,mBAAmB,CAAC,WAAW,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC,CAkCtE;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,WAAW,GAAG,SAAS,GACtC,mBAAmB,CAAC,WAAW,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC,CAMjE"}

package/dist/namespaces/tron/builders.d.ts

@@ -2,4 +2,7 @@ import type { TronActions } from './types.js';
 import { ActionBuilder } from '../../mod.js';
 export declare const connect: () => ActionBuilder<TronActions, "connect">;
 export declare const canEagerConnect: () => ActionBuilder<TronActions, "canEagerConnect">;
+export declare const getAllowance: () => ActionBuilder<TronActions, "getAllowance">;
+export declare const buildApproveTransaction: () => ActionBuilder<TronActions, "buildApproveTransaction">;
+export declare const getTransactionInfo: () => ActionBuilder<TronActions, "getTransactionInfo">;
 //# sourceMappingURL=builders.d.ts.map

package/dist/namespaces/tron/builders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/namespaces/tron/builders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAK7C,eAAO,MAAM,OAAO,6CAIc,CAAC;AAEnC,eAAO,MAAM,eAAe,qDAC0C,CAAC"}
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/namespaces/tron/builders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAK7C,eAAO,MAAM,OAAO,6CAIc,CAAC;AAEnC,eAAO,MAAM,eAAe,qDAC0C,CAAC;AAEvE,eAAO,MAAM,YAAY,kDACuC,CAAC;AAEjE,eAAO,MAAM,uBAAuB,6DAGjC,CAAC;AAEJ,eAAO,MAAM,kBAAkB,wDAC6C,CAAC"}

package/dist/namespaces/tron/constants.d.ts

@@ -1,3 +1,15 @@
 export declare const CAIP_NAMESPACE = "tron";
 export declare const CAIP_TRON_CHAIN_ID = "tron";
+/**
+ * Default fee limit (in SUN) for a client-built TRC-20 approve transaction.
+ * 250 TRX — matches the value the backend used for server-built approvals.
+ */
+export declare const DEFAULT_APPROVE_FEE_LIMIT = 250000000;
+/** The TRC-20 call the approve prerequisite issues. */
+export declare const APPROVE_FUNCTION_SELECTOR = "approve(address,uint256)";
+/**
+ * Length in hex characters of the function selector that prefixes a call's
+ * data: 4 bytes, two characters each.
+ */
+export declare const FUNCTION_SELECTOR_HEX_LENGTH = 8;
 //# sourceMappingURL=constants.d.ts.map

package/dist/namespaces/tron/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/namespaces/tron/constants.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,kBAAkB,SAAS,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/namespaces/tron/constants.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,yBAAyB,YAAc,CAAC;AAErD,uDAAuD;AACvD,eAAO,MAAM,yBAAyB,6BAA6B,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC"}

package/dist/namespaces/tron/mod.js

@@ -1,2 +1,2 @@
-var y=Object.defineProperty;var e=(o,t)=>y(o,"name",{value:t,configurable:!0});var n=(o,t)=>{for(var s in t)y(o,s,{get:t[s],enumerable:!0})};var S={};n(S,{recommended:()=>R});function g(o){let[,t]=o.state();t("network",null),t("accounts",null),t("connected",!1),t("connecting",!1),t("connectArgs",null)}e(g,"disconnect");var x=[["disconnect",g]];var R=[...x];var A={};n(A,{recommended:()=>O});function a(o){let[,t]=o.state();t("connecting",!1)}e(a,"intoConnectionFinished");var m=[["connect",a]];var O=[...m];var w={};n(w,{recommended:()=>M});import{createStore as Ye}from"zustand/vanilla";import{produce as ke}from"immer";import{produce as je}from"immer";var r=class{static{e(this,"ActionBuilder")}name;#e=new Map;#t=new Map;#o=new Map;#r=new Map;#n;constructor(t){this.name=t}and(t){return this.#e.has(this.name)||this.#e.set(this.name,[]),this.#e.get(this.name)?.push(t),this}or(t){return this.#t.has(this.name)||this.#t.set(this.name,[]),this.#t.get(this.name)?.push(t),this}before(t){return this.#r.has(this.name)||this.#r.set(this.name,[]),this.#r.get(this.name)?.push(t),this}after(t){return this.#o.has(this.name)||this.#o.set(this.name,[]),this.#o.get(this.name)?.push(t),this}action(t){return this.#n=t,this}build(){if(!this.#n)throw new Error("Your action builder should includes an action.");return{actionName:this.name,action:this.#n,before:this.#r,after:this.#o,and:this.#e,or:this.#t}}};import*as Ct from"caip";import{AccountId as W}from"caip";function P(o){try{return W.parse(o),!0}catch{return!1}}e(P,"isValidCaipAddress");function i(o,t){if(!t.every(P))throw new Error(`Your provider should format account addresses in CAIP-10 format. Your provided accounts: ${t}`);let[,s]=o.state();return s("accounts",t),s("connected",!0),t}e(i,"connectAndUpdateStateForSingleNetwork");function p(o){let[,t]=o.state();t("connecting",!0)}e(p,"intoConnecting");var l=[["connect",p]];var M=[["connect",i]];var E={};n(E,{recommended:()=>H});var H=[...l];var N={};n(N,{canEagerConnect:()=>B,connect:()=>U});var U=e(()=>new r("connect").and(i).before(p).after(a),"connect"),B=e(()=>new r("canEagerConnect"),"canEagerConnect");var I={};n(I,{formatAccountsToCAIP:()=>Y,isTronNamespace:()=>T});import{getNamespaceFromCaip2ChainId as L}from"@hub3js/std/utils";import{AccountId as $}from"caip";var d="tron",v="tron";function T(o){return L(o)===d}e(T,"isTronNamespace");function Y(o){return o.map(t=>$.format({address:t.toString(),chainId:{namespace:d,reference:v}}))}e(Y,"formatAccountsToCAIP");export{d as CAIP_NAMESPACE,v as CAIP_TRON_CHAIN_ID,S as actions,A as after,w as and,E as before,N as builders,T as isTronNamespace,I as utils};
+var N=Object.defineProperty;var e=(o,t)=>N(o,"name",{value:t,configurable:!0});var a=(o,t)=>{for(var r in t)N(o,r,{get:t[r],enumerable:!0})};var O={};a(O,{buildApproveTransaction:()=>q,getAllowance:()=>X,getTransactionInfo:()=>Q,recommended:()=>G});function I(o){let[,t]=o.state();t("network",null),t("accounts",null),t("connected",!1),t("connecting",!1),t("connectArgs",null)}e(I,"disconnect");var k=[["disconnect",I]];var f="tron",S="tron";var l="approve(address,uint256)";var R={};a(R,{buildApprovePayload:()=>A,formatAccountsToCAIP:()=>Y,getTronWeb:()=>c,hexAddressToTronBase58:()=>i,isTronNamespace:()=>_});import{getNamespaceFromCaip2ChainId as U}from"@hub3js/std/utils";import{AccountId as B}from"caip";function _(o){return U(o)===f}e(_,"isTronNamespace");function A(o,t){let n=o.raw_data?.contract?.[0]?.parameter?.value;if(!(!n?.data||!n.owner_address||!n.contract_address))return{type:"WEB",owner_address:n.owner_address,call_value:0,contract_address:n.contract_address,fee_limit:t,function_selector:l,parameter:n.data.slice(8),chainType:null}}e(A,"buildApprovePayload");function c(o){let t=o();if(!t?.tronWeb)throw new Error("Tron is not available on your wallet.");return t.tronWeb}e(c,"getTronWeb");var $="41";function i(o,t){let r=$+t.replace(/^0x/,"");return o.address.fromHex(r)}e(i,"hexAddressToTronBase58");function Y(o){return o.map(t=>B.format({address:t.toString(),chainId:{namespace:f,reference:S}}))}e(Y,"formatAccountsToCAIP");var G=[...k];function X(o){return async(t,r)=>{let n=c(o),p=i(n,r.owner),x=i(n,r.token),g=i(n,r.spender),{result:u,constant_result:m}=await n.transactionBuilder.triggerConstantContract(x,"allowance(address,address)",{},[{type:"address",value:p},{type:"address",value:g}],p);if(!u?.result||!m?.length)throw new Error("Failed to read the TRC-20 allowance.");return BigInt(`0x${m[0]}`).toString()}}e(X,"getAllowance");function q(o){return async(t,r)=>{let n=c(o),p=i(n,r.owner),x=i(n,r.token),g=i(n,r.spender),u=r.feeLimit??25e7,{result:m,transaction:T}=await n.transactionBuilder.triggerSmartContract(x,l,{feeLimit:u},[{type:"address",value:g},{type:"uint256",value:r.amount}],p);if(!m?.result)throw new Error("Failed to build the TRC-20 approve transaction.");return{...T,__payload__:A(T,u)}}}e(q,"buildApproveTransaction");function Q(o){return async(t,r)=>c(o).trx.getUnconfirmedTransactionInfo(r)}e(Q,"getTransactionInfo");var F={};a(F,{recommended:()=>Z});function h(o){let[,t]=o.state();t("connecting",!1)}e(h,"intoConnectionFinished");var b=[["connect",h]];var Z=[...b];var W={};a(W,{recommended:()=>ie});import{createStore as St}from"zustand/vanilla";import{produce as nt}from"immer";import{produce as pt}from"immer";var s=class{static{e(this,"ActionBuilder")}name;#e=new Map;#t=new Map;#o=new Map;#r=new Map;#n;constructor(t){this.name=t}and(t){return this.#e.has(this.name)||this.#e.set(this.name,[]),this.#e.get(this.name)?.push(t),this}or(t){return this.#t.has(this.name)||this.#t.set(this.name,[]),this.#t.get(this.name)?.push(t),this}before(t){return this.#r.has(this.name)||this.#r.set(this.name,[]),this.#r.get(this.name)?.push(t),this}after(t){return this.#o.has(this.name)||this.#o.set(this.name,[]),this.#o.get(this.name)?.push(t),this}action(t){return this.#n=t,this}build(){if(!this.#n)throw new Error("Your action builder should includes an action.");return{actionName:this.name,action:this.#n,before:this.#r,after:this.#o,and:this.#e,or:this.#t}}};import*as Qt from"caip";import{AccountId as se}from"caip";function D(o){try{return se.parse(o),!0}catch{return!1}}e(D,"isValidCaipAddress");function d(o,t){if(!t.every(D))throw new Error(`Your provider should format account addresses in CAIP-10 format. Your provided accounts: ${t}`);let[,r]=o.state();return r("accounts",t),r("connected",!0),t}e(d,"connectAndUpdateStateForSingleNetwork");function y(o){let[,t]=o.state();t("connecting",!0)}e(y,"intoConnecting");var w=[["connect",y]];var ie=[["connect",d]];var V={};a(V,{recommended:()=>ae});var ae=[...w];var M={};a(M,{buildApproveTransaction:()=>ue,canEagerConnect:()=>de,connect:()=>ce,getAllowance:()=>pe,getTransactionInfo:()=>me});var ce=e(()=>new s("connect").and(d).before(y).after(h),"connect"),de=e(()=>new s("canEagerConnect"),"canEagerConnect"),pe=e(()=>new s("getAllowance"),"getAllowance"),ue=e(()=>new s("buildApproveTransaction"),"buildApproveTransaction"),me=e(()=>new s("getTransactionInfo"),"getTransactionInfo");export{f as CAIP_NAMESPACE,S as CAIP_TRON_CHAIN_ID,O as actions,F as after,W as and,V as before,M as builders,_ as isTronNamespace,R as utils};
 //# sourceMappingURL=mod.js.map

package/dist/namespaces/tron/mod.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../../src/namespaces/tron/actions.ts", "../../../src/namespaces/common/actions.ts", "../../../src/namespaces/tron/after.ts", "../../../src/namespaces/common/after.ts", "../../../src/namespaces/tron/and.ts", "../../../src/hub/store/store.ts", "../../../src/hub/store/namespaces.ts", "../../../src/hub/store/providers.ts", "../../../src/builders/action.ts", "../../../src/utils/mod.ts", "../../../src/namespaces/common/helpers.ts", "../../../src/namespaces/common/and.ts", "../../../src/namespaces/common/before.ts", "../../../src/namespaces/tron/before.ts", "../../../src/namespaces/tron/builders.ts", "../../../src/namespaces/tron/utils.ts", "../../../src/namespaces/tron/constants.ts"],
-  "sourcesContent": ["import { recommended as commonRecommended } from '../common/actions.js';\n\nexport const recommended = [...commonRecommended];\n", "import type { Context } from '../../hub/namespaces/mod.js';\n\nexport function disconnect(context: Context): void {\n  const [, setState] = context.state();\n  setState('network', null);\n  setState('accounts', null);\n  setState('connected', false);\n  setState('connecting', false);\n  setState('connectArgs', null);\n}\n\nexport const recommended = [['disconnect', disconnect] as const];\n", "import { recommended as commonRecommended } from '../common/after.js';\n\nexport const recommended = [...commonRecommended];\n", "import type { Context } from '../../hub/namespaces/mod.js';\n\nexport function intoConnectionFinished(context: Context) {\n  const [, setState] = context.state();\n  setState('connecting', false);\n}\n\nexport const recommended = [['connect', intoConnectionFinished] as const];\n", "import { connectAndUpdateStateForSingleNetwork } from '../common/mod.js';\n\nexport const recommended = [\n  ['connect', connectAndUpdateStateForSingleNetwork] as const,\n];\n", "import type { StoreApi } from 'zustand/vanilla';\n\nimport { createStore as createZustandStore } from 'zustand/vanilla';\n\nimport { extend, type Store } from './extend.js';\nimport { hubStore, type HubStore } from './hub.js';\nimport { namespacesStore, type NamespaceStore } from './namespaces.js';\nimport { providersStore, type ProviderStore } from './providers.js';\n\n/************ State ************/\n\nexport interface State {\n  hub: HubStore;\n  providers: ProviderStore;\n  namespaces: NamespaceStore;\n}\n\nexport type RawStore = StoreApi<State>;\n\nexport const createStore = (): Store => {\n  const store = createZustandStore<State>((...api) => {\n    return {\n      hub: hubStore(...api),\n      providers: providersStore(...api),\n      namespaces: namespacesStore(...api),\n    };\n  });\n\n  return extend(store);\n};\n", "/************ Namespace ************/\n\nimport type { StateCreator } from 'zustand';\n\nimport { produce } from 'immer';\n\nimport {\n  ConsumableEvents,\n  type NamespaceConnectedEvent,\n  type NamespaceDisconnectedEvent,\n  type NamespaceSwitchedAccountEvent,\n  type NamespaceSwitchedNetworkEvent,\n} from './events.js';\nimport { namespaceStateSelector, type State } from './mod.js';\n\n// Currently, namespace doesn't has any config.\nexport type NamespaceConfig = object;\n\nexport interface NamespaceData {\n  accounts: null | string[];\n  network: null | string;\n  connected: boolean;\n  connecting: boolean;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  connectArgs: Record<string, any> | null;\n}\n\ninterface NamespaceInfo {\n  providerId: string;\n  namespaceId: string;\n}\n\ninterface NamespaceItem {\n  info: NamespaceInfo;\n  data: NamespaceData;\n  error: unknown;\n}\n\ntype NamespaceState = {\n  events: InstanceType<typeof ConsumableEvents>;\n  list: Record<string, NamespaceItem>;\n};\n\ninterface NamespaceActions {\n  addNamespace: (id: string, config: NamespaceInfo) => void;\n  updateStatus: <K extends keyof NamespaceData>(\n    id: string,\n    key: K,\n    value: NamespaceData[K]\n  ) => void;\n\n  _produceEventsWhenUpdatingStatus: <K extends keyof NamespaceData>(\n    namespace: NamespaceItem,\n    id: string,\n    key: K,\n    value: NamespaceData[K]\n  ) => void;\n}\ninterface NamespaceSelectors {\n  getNamespaceData(storeId: string): NamespaceData;\n}\n\nexport type NamespaceStore = NamespaceState &\n  NamespaceActions &\n  NamespaceSelectors;\ntype NamespaceStateCreator = StateCreator<State, [], [], NamespaceStore>;\n\nconst namespacesStore: NamespaceStateCreator = (set, get) => ({\n  events: new ConsumableEvents(),\n\n  list: {},\n  addNamespace: (id, info) => {\n    const data: NamespaceData = {\n      accounts: null,\n      network: null,\n      connected: false,\n      connecting: false,\n      connectArgs: null,\n    };\n\n    const item = {\n      data,\n      error: '',\n      info,\n    };\n\n    set(\n      produce((state: State) => {\n        state.namespaces.list[id] = item;\n      })\n    );\n  },\n  updateStatus: (id, key, value) => {\n    const ns = get().namespaces.list[id];\n    if (!ns) {\n      throw new Error(`No namespace with '${id}' found.`);\n    }\n\n    get().namespaces._produceEventsWhenUpdatingStatus(ns, id, key, value);\n\n    // Updating state\n    set(\n      produce((state: State) => {\n        state.namespaces.list[id].data[key] = value;\n      })\n    );\n  },\n  getNamespaceData(storeId) {\n    return namespaceStateSelector(get(), storeId);\n  },\n\n  _produceEventsWhenUpdatingStatus: (namespace, id, key, value) => {\n    if (key === 'accounts') {\n      // check for both null and empty array\n      const isAccountsEmpty =\n        Object.is(value, null) || (Array.isArray(value) && value.length === 0);\n\n      if (isAccountsEmpty) {\n        const currentConnectedStatus = get().namespaces.list[id].data.connected;\n        if (currentConnectedStatus) {\n          const event: NamespaceDisconnectedEvent = {\n            type: 'namespace_disconnected',\n            provider: namespace.info.providerId,\n            namespace: namespace.info.namespaceId,\n          };\n\n          get().namespaces.events.push(event);\n        }\n        // Skip emitting disconnect event, if the `connected` is false\n      } else {\n        const currentAccounts = get().namespaces.list[id].data.accounts;\n\n        if (!currentAccounts) {\n          const event: NamespaceConnectedEvent = {\n            type: 'namespace_connected',\n            provider: namespace.info.providerId,\n            namespace: namespace.info.namespaceId,\n            accounts: value as string[],\n          };\n\n          get().namespaces.events.push(event);\n        } else {\n          const areSameAccounts =\n            // Clone the object from the Zustand store, as it's immutable, to avoid errors during sorting.\n            [...currentAccounts].sort().toString() ===\n            (value as string[]).sort().toString();\n\n          if (!areSameAccounts) {\n            const event: NamespaceSwitchedAccountEvent = {\n              type: 'namespace_account_switched',\n              provider: namespace.info.providerId,\n              namespace: namespace.info.namespaceId,\n              previousAccounts: currentAccounts,\n              accounts: value as string[],\n            };\n\n            get().namespaces.events.push(event);\n          }\n        }\n      }\n    } else if (key === 'network') {\n      const currentNetwork = get().namespaces.list[id].data.network;\n\n      const event: NamespaceSwitchedNetworkEvent = {\n        type: 'namespace_network_switched',\n        provider: namespace.info.providerId,\n        namespace: namespace.info.namespaceId,\n        network: value as string,\n        previousNetwork: currentNetwork,\n      };\n\n      get().namespaces.events.push(event);\n    }\n  },\n});\n\nexport { namespacesStore };\n", "import type { Namespace } from '../../namespaces/common/types.js';\nimport type { State as InternalProviderState } from '../provider/mod.js';\nimport type { SignerFactory } from 'rango-types';\nimport type { StateCreator } from 'zustand';\n\nimport { produce } from 'immer';\n\nimport { ConsumableEvents, type ProviderDetectedEvent } from './events.js';\nimport { guessProviderStateSelector, type State } from './mod.js';\n\ntype Browsers = 'firefox' | 'chrome' | 'edge' | 'brave' | 'homepage';\ntype Property<N extends string, V> = { name: N; value: V };\n\ntype NamespacesProperty = Property<\n  'namespaces',\n  {\n    selection: 'single' | 'multiple';\n    data: {\n      label: string;\n      id: string;\n      value: Namespace;\n      unsupported?: boolean;\n      isChainSupported: (chain: string) => boolean;\n    }[];\n  }\n>;\ntype DerivationPathProperty = Property<\n  'derivationPath',\n  {\n    data: {\n      id: string;\n      label: string;\n      namespace: Namespace;\n      generateDerivationPath: (index: string) => string;\n    }[];\n  }\n>;\ntype DetailsProperty = Property<\n  'details',\n  {\n    mobileWallet?: boolean;\n    showOnMobile?: boolean;\n    isContractWallet?: boolean;\n  }\n>;\ntype SignersProperty = Property<\n  'signers',\n  {\n    getSigners: () => Promise<SignerFactory>;\n  }\n>;\n\nexport type ProviderMetadata = {\n  name: string;\n  icon: string;\n  extensions: Partial<Record<Browsers, string>>;\n  properties?: Array<\n    | NamespacesProperty\n    | DerivationPathProperty\n    | DetailsProperty\n    | SignersProperty\n  >;\n};\n\nexport interface ProviderConfig {\n  metadata: ProviderMetadata;\n}\n\nexport type ProviderInfo = ProviderConfig;\n\ninterface ProviderData {\n  installed: boolean;\n}\n\ninterface ProviderItem {\n  config: ProviderConfig;\n  data: ProviderData;\n  error: unknown;\n}\n\ntype ProviderState = {\n  events: ConsumableEvents;\n  list: Record<string, ProviderItem>;\n};\ninterface ProviderActions {\n  addProvider: (id: string, config: ProviderConfig) => void;\n  removeProvider: (id: string) => void;\n  updateStatus: <K extends keyof ProviderData>(\n    id: string,\n    key: K,\n    value: ProviderData[K]\n  ) => void;\n\n  _produceEventsWhenUpdatingStatus: <K extends keyof ProviderData>(\n    provider: ProviderItem,\n    id: string,\n    key: K,\n    value: ProviderData[K]\n  ) => void;\n}\n\ninterface ProviderSelectors {\n  /**\n   * Provider has a limited state to itself, to be compatible with legacy, we try to produce same object as legacy\n   * which includes namespace state as well.\n   */\n  guessNamespacesState: (id: string) => InternalProviderState;\n}\n\nexport type ProviderStore = ProviderState & ProviderActions & ProviderSelectors;\ntype ProvidersStateCreator = StateCreator<State, [], [], ProviderStore>;\n\nconst providersStore: ProvidersStateCreator = (set, get) => ({\n  events: new ConsumableEvents(),\n\n  list: {},\n  addProvider: (id, config) => {\n    const item = {\n      data: {\n        installed: false,\n      },\n      error: '',\n      config,\n    };\n\n    set(\n      produce((state: State) => {\n        state.providers.list[id] = item;\n      })\n    );\n  },\n  removeProvider: (id) => {\n    set(\n      produce((state: State) => {\n        delete state.providers.list[id];\n      })\n    );\n  },\n  updateStatus: (id, key, value) => {\n    const provider = get().providers.list[id];\n    if (!provider) {\n      throw new Error(`No namespace namespace with '${id}' found.`);\n    }\n\n    get().providers._produceEventsWhenUpdatingStatus(provider, id, key, value);\n\n    set(\n      produce((state: State) => {\n        state.providers.list[id].data[key] = value;\n      })\n    );\n  },\n  guessNamespacesState: (providerId: string): InternalProviderState => {\n    return guessProviderStateSelector(get(), providerId);\n  },\n\n  _produceEventsWhenUpdatingStatus: (_provider, id, key, _value) => {\n    if (key === 'installed') {\n      const event: ProviderDetectedEvent = {\n        type: 'provider_detected',\n        provider: id,\n      };\n\n      get().providers.events.push(event);\n    }\n  },\n});\n\nexport { providersStore };\n", "import type { Actions, Context, Operators } from '../hub/namespaces/types.js';\nimport type { AnyFunction, FunctionWithContext } from '../types/actions.js';\n\nexport interface ActionByBuilder<T, Context> {\n  actionName: keyof T;\n  and: Operators<T>;\n  or: Operators<T>;\n  after: Operators<T>;\n  before: Operators<T>;\n  action: FunctionWithContext<T[keyof T], Context>;\n}\n\n/*\n * TODO:\n * Currently, to use this builder you will write something like this:\n * new ActionBuilder<EvmActions, 'disconnect'>('disconnect').after(....)\n *\n * I couldn't figure it out to be able typescript infer the constructor value as key of actions.\n * Ideal usage:\n * new ActionBuilder<EvmActions>('disconnect').after(....)\n *\n */\nexport class ActionBuilder<T extends Actions<T>, K extends keyof T> {\n  readonly name: K;\n  #and: Operators<T> = new Map();\n  #or: Operators<T> = new Map();\n  #after: Operators<T> = new Map();\n  #before: Operators<T> = new Map();\n  #action: FunctionWithContext<T[keyof T], Context<T>> | undefined;\n\n  constructor(name: K) {\n    this.name = name;\n  }\n\n  public and(action: FunctionWithContext<AnyFunction, Context<T>>) {\n    if (!this.#and.has(this.name)) {\n      this.#and.set(this.name, []);\n    }\n    this.#and.get(this.name)?.push(action);\n    return this;\n  }\n\n  public or(action: FunctionWithContext<AnyFunction, Context<T>>) {\n    if (!this.#or.has(this.name)) {\n      this.#or.set(this.name, []);\n    }\n    this.#or.get(this.name)?.push(action);\n    return this;\n  }\n\n  public before(action: FunctionWithContext<AnyFunction, Context<T>>) {\n    if (!this.#before.has(this.name)) {\n      this.#before.set(this.name, []);\n    }\n    this.#before.get(this.name)?.push(action);\n    return this;\n  }\n\n  public after(action: FunctionWithContext<AnyFunction, Context<T>>) {\n    if (!this.#after.has(this.name)) {\n      this.#after.set(this.name, []);\n    }\n    this.#after.get(this.name)?.push(action);\n    return this;\n  }\n\n  public action(action: FunctionWithContext<T[keyof T], Context<T>>) {\n    this.#action = action;\n    return this;\n  }\n\n  public build(): ActionByBuilder<T, Context<T>> {\n    if (!this.#action) {\n      throw new Error('Your action builder should includes an action.');\n    }\n\n    return {\n      actionName: this.name,\n      action: this.#action,\n      before: this.#before,\n      after: this.#after,\n      and: this.#and,\n      or: this.#or,\n    };\n  }\n}\n", "/*\n * It is not a good idea to re-export all of CAIP because if they have a breaking change, we will break as well.\n * It would be better to create an abstraction over them and export our own interface to ensure it is under our control.\n */\nexport * as CAIP from 'caip';\n\nexport { generateStoreId } from '../hub/helpers.js';\nexport * from './versions.js';\n", "import { AccountId } from 'caip';\n\nexport function isValidCaipAddress(address: string): boolean {\n  try {\n    AccountId.parse(address);\n    return true;\n  } catch {\n    return false;\n  }\n}\n", "import type {\n  Accounts,\n  AccountsWithActiveChain,\n} from './../../types/accounts.js';\nimport type { Context } from '../../hub/namespaces/mod.js';\n\nimport { isValidCaipAddress } from './helpers.js';\n\nexport function connectAndUpdateStateForSingleNetwork(\n  context: Context,\n  accounts: Accounts\n) {\n  if (!accounts.every(isValidCaipAddress)) {\n    throw new Error(\n      `Your provider should format account addresses in CAIP-10 format. Your provided accounts: ${accounts}`\n    );\n  }\n\n  const [, setState] = context.state();\n  setState('accounts', accounts);\n  setState('connected', true);\n  return accounts;\n}\n\nexport function connectAndUpdateStateForMultiNetworks(\n  context: Context,\n  accounts: AccountsWithActiveChain\n) {\n  if (!accounts.accounts.every(isValidCaipAddress)) {\n    throw new Error(\n      `Your provider should format account addresses in CAIP-10 format. Your provided accounts: ${accounts.accounts}`\n    );\n  }\n\n  const [, setState] = context.state();\n  setState('accounts', accounts.accounts);\n  setState('network', accounts.network);\n  setState('connected', true);\n  return accounts;\n}\n\nexport const recommended = [];\n", "import type { Context } from '../../hub/namespaces/mod.js';\n\nexport function intoConnecting(context: Context) {\n  const [, setState] = context.state();\n  setState('connecting', true);\n}\n\n// Please consider if you are going to add something here, make sure it works on all namespaces.\nexport const recommended = [['connect', intoConnecting] as const];\n", "import { recommended as commonRecommended } from '../common/before.js';\n\nexport const recommended = [...commonRecommended];\n", "import type { TronActions } from './types.js';\n\nimport { ActionBuilder } from '../../mod.js';\nimport { intoConnectionFinished } from '../common/after.js';\nimport { connectAndUpdateStateForSingleNetwork } from '../common/and.js';\nimport { intoConnecting } from '../common/before.js';\n\nexport const connect = () =>\n  new ActionBuilder<TronActions, 'connect'>('connect')\n    .and(connectAndUpdateStateForSingleNetwork)\n    .before(intoConnecting)\n    .after(intoConnectionFinished);\n\nexport const canEagerConnect = () =>\n  new ActionBuilder<TronActions, 'canEagerConnect'>('canEagerConnect');\n", "import type { CaipAccount } from '../common/mod.js';\n\nimport { getNamespaceFromCaip2ChainId } from '@hub3js/std/utils';\nimport { AccountId } from 'caip';\n\nimport { CAIP_NAMESPACE, CAIP_TRON_CHAIN_ID } from './constants.js';\n\nexport function isTronNamespace(caip2ChainId: string): boolean {\n  return getNamespaceFromCaip2ChainId(caip2ChainId) === CAIP_NAMESPACE;\n}\n\nexport function formatAccountsToCAIP(accounts: string[]) {\n  return accounts.map(\n    (account) =>\n      AccountId.format({\n        address: account.toString(),\n        chainId: {\n          namespace: CAIP_NAMESPACE,\n          reference: CAIP_TRON_CHAIN_ID,\n        },\n      }) as CaipAccount\n  );\n}\n", "/*\n * TODO: I couldn't found tron in caip\n * @see https://namespaces.chainagnostic.org/\n */\n\n// if the value needs to be change make sure you will update mapCaipNamespaceToLegacyNetworkName as well\nexport const CAIP_NAMESPACE = 'tron';\nexport const CAIP_TRON_CHAIN_ID = 'tron';\n"],
-  "mappings": "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",
-  "names": ["actions_exports", "__export", "recommended", "disconnect", "context", "setState", "__name", "recommended", "recommended", "after_exports", "__export", "recommended", "intoConnectionFinished", "context", "setState", "__name", "recommended", "recommended", "and_exports", "__export", "recommended", "createZustandStore", "produce", "produce", "ActionBuilder", "__name", "#and", "#or", "#after", "#before", "#action", "name", "action", "CAIP", "AccountId", "isValidCaipAddress", "address", "AccountId", "__name", "connectAndUpdateStateForSingleNetwork", "context", "accounts", "isValidCaipAddress", "setState", "__name", "intoConnecting", "context", "setState", "__name", "recommended", "recommended", "connectAndUpdateStateForSingleNetwork", "before_exports", "__export", "recommended", "recommended", "builders_exports", "__export", "canEagerConnect", "connect", "connect", "__name", "ActionBuilder", "connectAndUpdateStateForSingleNetwork", "intoConnecting", "intoConnectionFinished", "canEagerConnect", "utils_exports", "__export", "formatAccountsToCAIP", "isTronNamespace", "getNamespaceFromCaip2ChainId", "AccountId", "CAIP_NAMESPACE", "CAIP_TRON_CHAIN_ID", "isTronNamespace", "caip2ChainId", "getNamespaceFromCaip2ChainId", "CAIP_NAMESPACE", "__name", "formatAccountsToCAIP", "accounts", "account", "AccountId", "CAIP_TRON_CHAIN_ID"]
+  "sources": ["../../../src/namespaces/tron/actions.ts", "../../../src/namespaces/common/actions.ts", "../../../src/namespaces/tron/constants.ts", "../../../src/namespaces/tron/utils.ts", "../../../src/namespaces/tron/after.ts", "../../../src/namespaces/common/after.ts", "../../../src/namespaces/tron/and.ts", "../../../src/hub/store/store.ts", "../../../src/hub/store/namespaces.ts", "../../../src/hub/store/providers.ts", "../../../src/builders/action.ts", "../../../src/utils/mod.ts", "../../../src/namespaces/common/helpers.ts", "../../../src/namespaces/common/and.ts", "../../../src/namespaces/common/before.ts", "../../../src/namespaces/tron/before.ts", "../../../src/namespaces/tron/builders.ts"],
+  "sourcesContent": ["import type { ProviderAPI, TronActions } from './types.js';\nimport type { Context } from '../../hub/namespaces/mod.js';\nimport type { FunctionWithContext } from '../../types/actions.js';\n\nimport { recommended as commonRecommended } from '../common/actions.js';\n\nimport {\n  APPROVE_FUNCTION_SELECTOR,\n  DEFAULT_APPROVE_FEE_LIMIT,\n} from './constants.js';\nimport {\n  buildApprovePayload,\n  getTronWeb,\n  hexAddressToTronBase58,\n} from './utils.js';\n\nexport const recommended = [...commonRecommended];\n\n/**\n * Reads a TRC-20 `allowance(owner, spender)` via a constant contract call and\n * returns it as a decimal string.\n */\nexport function getAllowance(\n  instance: () => ProviderAPI | undefined\n): FunctionWithContext<TronActions['getAllowance'], Context> {\n  return async (_context, params) => {\n    const tronWeb = getTronWeb(instance);\n    const owner = hexAddressToTronBase58(tronWeb, params.owner);\n    const token = hexAddressToTronBase58(tronWeb, params.token);\n    const spender = hexAddressToTronBase58(tronWeb, params.spender);\n\n    const { result, constant_result } =\n      await tronWeb.transactionBuilder.triggerConstantContract(\n        token,\n        'allowance(address,address)',\n        {},\n        [\n          { type: 'address', value: owner },\n          { type: 'address', value: spender },\n        ],\n        owner\n      );\n\n    if (!result?.result || !constant_result?.length) {\n      throw new Error('Failed to read the TRC-20 allowance.');\n    }\n\n    return BigInt(`0x${constant_result[0]}`).toString();\n  };\n}\n\n/**\n * Builds (via the node) a ready-to-sign `approve(spender, amount)` transaction\n * on the TRC-20 token contract.\n *\n * The transaction carries TronWeb's default 60s expiration, which is the same\n * window server-built approvals use.\n */\nexport function buildApproveTransaction(\n  instance: () => ProviderAPI | undefined\n): FunctionWithContext<TronActions['buildApproveTransaction'], Context> {\n  return async (_context, params) => {\n    const tronWeb = getTronWeb(instance);\n    const owner = hexAddressToTronBase58(tronWeb, params.owner);\n    const token = hexAddressToTronBase58(tronWeb, params.token);\n    const spender = hexAddressToTronBase58(tronWeb, params.spender);\n\n    const feeLimit = params.feeLimit ?? DEFAULT_APPROVE_FEE_LIMIT;\n    const { result, transaction } =\n      await tronWeb.transactionBuilder.triggerSmartContract(\n        token,\n        APPROVE_FUNCTION_SELECTOR,\n        { feeLimit },\n        [\n          { type: 'address', value: spender },\n          { type: 'uint256', value: params.amount },\n        ],\n        owner\n      );\n\n    if (!result?.result) {\n      throw new Error('Failed to build the TRC-20 approve transaction.');\n    }\n\n    /*\n     * `transactionBuilder` returns only the consensus fields. A server-built\n     * transaction also carries `__payload__`, which wallets use to re-issue the\n     * call when the user edits the allowance, so add it here too.\n     */\n    return {\n      ...transaction,\n      __payload__: buildApprovePayload(transaction, feeLimit),\n    };\n  };\n}\n\n/** Reads a transaction's on-chain info (empty while the tx is unconfirmed). */\nexport function getTransactionInfo(\n  instance: () => ProviderAPI | undefined\n): FunctionWithContext<TronActions['getTransactionInfo'], Context> {\n  return async (_context, txID) => {\n    const tronWeb = getTronWeb(instance);\n    // Full node (not solidity), so the info is available right after inclusion.\n    return tronWeb.trx.getUnconfirmedTransactionInfo(txID);\n  };\n}\n", "import type { Context } from '../../hub/namespaces/mod.js';\n\nexport function disconnect(context: Context): void {\n  const [, setState] = context.state();\n  setState('network', null);\n  setState('accounts', null);\n  setState('connected', false);\n  setState('connecting', false);\n  setState('connectArgs', null);\n}\n\nexport const recommended = [['disconnect', disconnect] as const];\n", "/*\n * TODO: I couldn't found tron in caip\n * @see https://namespaces.chainagnostic.org/\n */\n\n// if the value needs to be change make sure you will update mapCaipNamespaceToLegacyNetworkName as well\nexport const CAIP_NAMESPACE = 'tron';\nexport const CAIP_TRON_CHAIN_ID = 'tron';\n\n/**\n * Default fee limit (in SUN) for a client-built TRC-20 approve transaction.\n * 250 TRX \u2014 matches the value the backend used for server-built approvals.\n */\nexport const DEFAULT_APPROVE_FEE_LIMIT = 250_000_000;\n\n/** The TRC-20 call the approve prerequisite issues. */\nexport const APPROVE_FUNCTION_SELECTOR = 'approve(address,uint256)';\n\n/**\n * Length in hex characters of the function selector that prefixes a call's\n * data: 4 bytes, two characters each.\n */\nexport const FUNCTION_SELECTOR_HEX_LENGTH = 8;\n", "import type {\n  ProviderAPI,\n  TronBuiltTransaction,\n  TronRawDataContract,\n  TronTransactionPayload,\n  TronWebApi,\n} from './types.js';\nimport type { CaipAccount } from '../common/mod.js';\n\nimport { getNamespaceFromCaip2ChainId } from '@hub3js/std/utils';\nimport { AccountId } from 'caip';\n\nimport {\n  APPROVE_FUNCTION_SELECTOR,\n  CAIP_NAMESPACE,\n  CAIP_TRON_CHAIN_ID,\n  FUNCTION_SELECTOR_HEX_LENGTH,\n} from './constants.js';\n\nexport function isTronNamespace(caip2ChainId: string): boolean {\n  return getNamespaceFromCaip2ChainId(caip2ChainId) === CAIP_NAMESPACE;\n}\n\n/**\n * Describes a built approve call the way a server-built transaction does.\n *\n * Wallets that let the user choose the allowance rebuild the transaction from\n * `__payload__` instead of decoding `raw_data`. TronWeb's `transactionBuilder`\n * leaves it out, and given an empty one TronLink cannot re-issue the call and\n * reports \"Modification failed\", so the approve can never be signed there.\n *\n * The values are read back out of the built transaction rather than recomputed,\n * so they cannot drift from what was actually built and signed.\n */\nexport function buildApprovePayload(\n  transaction: TronBuiltTransaction,\n  feeLimit: number\n): TronTransactionPayload | undefined {\n  const rawData = transaction.raw_data as\n    | { contract?: TronRawDataContract[] }\n    | undefined;\n  const call = rawData?.contract?.[0]?.parameter?.value;\n\n  if (!call?.data || !call.owner_address || !call.contract_address) {\n    return undefined;\n  }\n\n  return {\n    type: 'WEB',\n    owner_address: call.owner_address,\n    call_value: 0,\n    contract_address: call.contract_address,\n    fee_limit: feeLimit,\n    function_selector: APPROVE_FUNCTION_SELECTOR,\n    parameter: call.data.slice(FUNCTION_SELECTOR_HEX_LENGTH),\n    chainType: null,\n  };\n}\n\n/** The wallet-injected TronWeb instance, or a readable error when absent. */\nexport function getTronWeb(\n  instance: () => ProviderAPI | undefined\n): TronWebApi {\n  const tronInstance = instance();\n  if (!tronInstance?.tronWeb) {\n    throw new Error('Tron is not available on your wallet.');\n  }\n  return tronInstance.tronWeb;\n}\n\n/** Tron mainnet address prefix byte (0x41) in hex. */\nconst TRON_HEX_ADDRESS_PREFIX = '41';\n\n/**\n * Prerequisite addresses arrive in 0x-hex (EVM-style) form; TronWeb expects a\n * Tron address. Convert `0x<20-bytes>` \u2192 `41<20-bytes>` \u2192 Base58.\n */\nexport function hexAddressToTronBase58(\n  tronWeb: TronWebApi,\n  address: string\n): string {\n  const tronHex = TRON_HEX_ADDRESS_PREFIX + address.replace(/^0x/, '');\n  return tronWeb.address.fromHex(tronHex);\n}\n\nexport function formatAccountsToCAIP(accounts: string[]) {\n  return accounts.map(\n    (account) =>\n      AccountId.format({\n        address: account.toString(),\n        chainId: {\n          namespace: CAIP_NAMESPACE,\n          reference: CAIP_TRON_CHAIN_ID,\n        },\n      }) as CaipAccount\n  );\n}\n", "import { recommended as commonRecommended } from '../common/after.js';\n\nexport const recommended = [...commonRecommended];\n", "import type { Context } from '../../hub/namespaces/mod.js';\n\nexport function intoConnectionFinished(context: Context) {\n  const [, setState] = context.state();\n  setState('connecting', false);\n}\n\nexport const recommended = [['connect', intoConnectionFinished] as const];\n", "import { connectAndUpdateStateForSingleNetwork } from '../common/mod.js';\n\nexport const recommended = [\n  ['connect', connectAndUpdateStateForSingleNetwork] as const,\n];\n", "import type { StoreApi } from 'zustand/vanilla';\n\nimport { createStore as createZustandStore } from 'zustand/vanilla';\n\nimport { extend, type Store } from './extend.js';\nimport { hubStore, type HubStore } from './hub.js';\nimport { namespacesStore, type NamespaceStore } from './namespaces.js';\nimport { providersStore, type ProviderStore } from './providers.js';\n\n/************ State ************/\n\nexport interface State {\n  hub: HubStore;\n  providers: ProviderStore;\n  namespaces: NamespaceStore;\n}\n\nexport type RawStore = StoreApi<State>;\n\nexport const createStore = (): Store => {\n  const store = createZustandStore<State>((...api) => {\n    return {\n      hub: hubStore(...api),\n      providers: providersStore(...api),\n      namespaces: namespacesStore(...api),\n    };\n  });\n\n  return extend(store);\n};\n", "/************ Namespace ************/\n\nimport type { StateCreator } from 'zustand';\n\nimport { produce } from 'immer';\n\nimport {\n  ConsumableEvents,\n  type NamespaceConnectedEvent,\n  type NamespaceDisconnectedEvent,\n  type NamespaceSwitchedAccountEvent,\n  type NamespaceSwitchedNetworkEvent,\n} from './events.js';\nimport { namespaceStateSelector, type State } from './mod.js';\n\n// Currently, namespace doesn't has any config.\nexport type NamespaceConfig = object;\n\nexport interface NamespaceData {\n  accounts: null | string[];\n  network: null | string;\n  connected: boolean;\n  connecting: boolean;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  connectArgs: Record<string, any> | null;\n}\n\ninterface NamespaceInfo {\n  providerId: string;\n  namespaceId: string;\n}\n\ninterface NamespaceItem {\n  info: NamespaceInfo;\n  data: NamespaceData;\n  error: unknown;\n}\n\ntype NamespaceState = {\n  events: InstanceType<typeof ConsumableEvents>;\n  list: Record<string, NamespaceItem>;\n};\n\ninterface NamespaceActions {\n  addNamespace: (id: string, config: NamespaceInfo) => void;\n  updateStatus: <K extends keyof NamespaceData>(\n    id: string,\n    key: K,\n    value: NamespaceData[K]\n  ) => void;\n\n  _produceEventsWhenUpdatingStatus: <K extends keyof NamespaceData>(\n    namespace: NamespaceItem,\n    id: string,\n    key: K,\n    value: NamespaceData[K]\n  ) => void;\n}\ninterface NamespaceSelectors {\n  getNamespaceData(storeId: string): NamespaceData;\n}\n\nexport type NamespaceStore = NamespaceState &\n  NamespaceActions &\n  NamespaceSelectors;\ntype NamespaceStateCreator = StateCreator<State, [], [], NamespaceStore>;\n\nconst namespacesStore: NamespaceStateCreator = (set, get) => ({\n  events: new ConsumableEvents(),\n\n  list: {},\n  addNamespace: (id, info) => {\n    const data: NamespaceData = {\n      accounts: null,\n      network: null,\n      connected: false,\n      connecting: false,\n      connectArgs: null,\n    };\n\n    const item = {\n      data,\n      error: '',\n      info,\n    };\n\n    set(\n      produce((state: State) => {\n        state.namespaces.list[id] = item;\n      })\n    );\n  },\n  updateStatus: (id, key, value) => {\n    const ns = get().namespaces.list[id];\n    if (!ns) {\n      throw new Error(`No namespace with '${id}' found.`);\n    }\n\n    get().namespaces._produceEventsWhenUpdatingStatus(ns, id, key, value);\n\n    // Updating state\n    set(\n      produce((state: State) => {\n        state.namespaces.list[id].data[key] = value;\n      })\n    );\n  },\n  getNamespaceData(storeId) {\n    return namespaceStateSelector(get(), storeId);\n  },\n\n  _produceEventsWhenUpdatingStatus: (namespace, id, key, value) => {\n    if (key === 'accounts') {\n      // check for both null and empty array\n      const isAccountsEmpty =\n        Object.is(value, null) || (Array.isArray(value) && value.length === 0);\n\n      if (isAccountsEmpty) {\n        const currentConnectedStatus = get().namespaces.list[id].data.connected;\n        if (currentConnectedStatus) {\n          const event: NamespaceDisconnectedEvent = {\n            type: 'namespace_disconnected',\n            provider: namespace.info.providerId,\n            namespace: namespace.info.namespaceId,\n          };\n\n          get().namespaces.events.push(event);\n        }\n        // Skip emitting disconnect event, if the `connected` is false\n      } else {\n        const currentAccounts = get().namespaces.list[id].data.accounts;\n\n        if (!currentAccounts) {\n          const event: NamespaceConnectedEvent = {\n            type: 'namespace_connected',\n            provider: namespace.info.providerId,\n            namespace: namespace.info.namespaceId,\n            accounts: value as string[],\n          };\n\n          get().namespaces.events.push(event);\n        } else {\n          const areSameAccounts =\n            // Clone the object from the Zustand store, as it's immutable, to avoid errors during sorting.\n            [...currentAccounts].sort().toString() ===\n            (value as string[]).sort().toString();\n\n          if (!areSameAccounts) {\n            const event: NamespaceSwitchedAccountEvent = {\n              type: 'namespace_account_switched',\n              provider: namespace.info.providerId,\n              namespace: namespace.info.namespaceId,\n              previousAccounts: currentAccounts,\n              accounts: value as string[],\n            };\n\n            get().namespaces.events.push(event);\n          }\n        }\n      }\n    } else if (key === 'network') {\n      const currentNetwork = get().namespaces.list[id].data.network;\n\n      const event: NamespaceSwitchedNetworkEvent = {\n        type: 'namespace_network_switched',\n        provider: namespace.info.providerId,\n        namespace: namespace.info.namespaceId,\n        network: value as string,\n        previousNetwork: currentNetwork,\n      };\n\n      get().namespaces.events.push(event);\n    }\n  },\n});\n\nexport { namespacesStore };\n", "import type { Namespace } from '../../namespaces/common/types.js';\nimport type { State as InternalProviderState } from '../provider/mod.js';\nimport type { SignerFactory } from 'rango-types';\nimport type { StateCreator } from 'zustand';\n\nimport { produce } from 'immer';\n\nimport { ConsumableEvents, type ProviderDetectedEvent } from './events.js';\nimport { guessProviderStateSelector, type State } from './mod.js';\n\ntype Browsers = 'firefox' | 'chrome' | 'edge' | 'brave' | 'homepage';\ntype Property<N extends string, V> = { name: N; value: V };\n\ntype NamespacesProperty = Property<\n  'namespaces',\n  {\n    selection: 'single' | 'multiple';\n    data: {\n      label: string;\n      id: string;\n      value: Namespace;\n      unsupported?: boolean;\n      isChainSupported: (chain: string) => boolean;\n    }[];\n  }\n>;\ntype DerivationPathProperty = Property<\n  'derivationPath',\n  {\n    data: {\n      id: string;\n      label: string;\n      namespace: Namespace;\n      generateDerivationPath: (index: string) => string;\n    }[];\n  }\n>;\ntype DetailsProperty = Property<\n  'details',\n  {\n    mobileWallet?: boolean;\n    showOnMobile?: boolean;\n    isContractWallet?: boolean;\n  }\n>;\ntype SignersProperty = Property<\n  'signers',\n  {\n    getSigners: () => Promise<SignerFactory>;\n  }\n>;\n\nexport type ProviderMetadata = {\n  name: string;\n  icon: string;\n  extensions: Partial<Record<Browsers, string>>;\n  properties?: Array<\n    | NamespacesProperty\n    | DerivationPathProperty\n    | DetailsProperty\n    | SignersProperty\n  >;\n};\n\nexport interface ProviderConfig {\n  metadata: ProviderMetadata;\n}\n\nexport type ProviderInfo = ProviderConfig;\n\ninterface ProviderData {\n  installed: boolean;\n}\n\ninterface ProviderItem {\n  config: ProviderConfig;\n  data: ProviderData;\n  error: unknown;\n}\n\ntype ProviderState = {\n  events: ConsumableEvents;\n  list: Record<string, ProviderItem>;\n};\ninterface ProviderActions {\n  addProvider: (id: string, config: ProviderConfig) => void;\n  removeProvider: (id: string) => void;\n  updateStatus: <K extends keyof ProviderData>(\n    id: string,\n    key: K,\n    value: ProviderData[K]\n  ) => void;\n\n  _produceEventsWhenUpdatingStatus: <K extends keyof ProviderData>(\n    provider: ProviderItem,\n    id: string,\n    key: K,\n    value: ProviderData[K]\n  ) => void;\n}\n\ninterface ProviderSelectors {\n  /**\n   * Provider has a limited state to itself, to be compatible with legacy, we try to produce same object as legacy\n   * which includes namespace state as well.\n   */\n  guessNamespacesState: (id: string) => InternalProviderState;\n}\n\nexport type ProviderStore = ProviderState & ProviderActions & ProviderSelectors;\ntype ProvidersStateCreator = StateCreator<State, [], [], ProviderStore>;\n\nconst providersStore: ProvidersStateCreator = (set, get) => ({\n  events: new ConsumableEvents(),\n\n  list: {},\n  addProvider: (id, config) => {\n    const item = {\n      data: {\n        installed: false,\n      },\n      error: '',\n      config,\n    };\n\n    set(\n      produce((state: State) => {\n        state.providers.list[id] = item;\n      })\n    );\n  },\n  removeProvider: (id) => {\n    set(\n      produce((state: State) => {\n        delete state.providers.list[id];\n      })\n    );\n  },\n  updateStatus: (id, key, value) => {\n    const provider = get().providers.list[id];\n    if (!provider) {\n      throw new Error(`No namespace namespace with '${id}' found.`);\n    }\n\n    get().providers._produceEventsWhenUpdatingStatus(provider, id, key, value);\n\n    set(\n      produce((state: State) => {\n        state.providers.list[id].data[key] = value;\n      })\n    );\n  },\n  guessNamespacesState: (providerId: string): InternalProviderState => {\n    return guessProviderStateSelector(get(), providerId);\n  },\n\n  _produceEventsWhenUpdatingStatus: (_provider, id, key, _value) => {\n    if (key === 'installed') {\n      const event: ProviderDetectedEvent = {\n        type: 'provider_detected',\n        provider: id,\n      };\n\n      get().providers.events.push(event);\n    }\n  },\n});\n\nexport { providersStore };\n", "import type { Actions, Context, Operators } from '../hub/namespaces/types.js';\nimport type { AnyFunction, FunctionWithContext } from '../types/actions.js';\n\nexport interface ActionByBuilder<T, Context> {\n  actionName: keyof T;\n  and: Operators<T>;\n  or: Operators<T>;\n  after: Operators<T>;\n  before: Operators<T>;\n  action: FunctionWithContext<T[keyof T], Context>;\n}\n\n/*\n * TODO:\n * Currently, to use this builder you will write something like this:\n * new ActionBuilder<EvmActions, 'disconnect'>('disconnect').after(....)\n *\n * I couldn't figure it out to be able typescript infer the constructor value as key of actions.\n * Ideal usage:\n * new ActionBuilder<EvmActions>('disconnect').after(....)\n *\n */\nexport class ActionBuilder<T extends Actions<T>, K extends keyof T> {\n  readonly name: K;\n  #and: Operators<T> = new Map();\n  #or: Operators<T> = new Map();\n  #after: Operators<T> = new Map();\n  #before: Operators<T> = new Map();\n  #action: FunctionWithContext<T[keyof T], Context<T>> | undefined;\n\n  constructor(name: K) {\n    this.name = name;\n  }\n\n  public and(action: FunctionWithContext<AnyFunction, Context<T>>) {\n    if (!this.#and.has(this.name)) {\n      this.#and.set(this.name, []);\n    }\n    this.#and.get(this.name)?.push(action);\n    return this;\n  }\n\n  public or(action: FunctionWithContext<AnyFunction, Context<T>>) {\n    if (!this.#or.has(this.name)) {\n      this.#or.set(this.name, []);\n    }\n    this.#or.get(this.name)?.push(action);\n    return this;\n  }\n\n  public before(action: FunctionWithContext<AnyFunction, Context<T>>) {\n    if (!this.#before.has(this.name)) {\n      this.#before.set(this.name, []);\n    }\n    this.#before.get(this.name)?.push(action);\n    return this;\n  }\n\n  public after(action: FunctionWithContext<AnyFunction, Context<T>>) {\n    if (!this.#after.has(this.name)) {\n      this.#after.set(this.name, []);\n    }\n    this.#after.get(this.name)?.push(action);\n    return this;\n  }\n\n  public action(action: FunctionWithContext<T[keyof T], Context<T>>) {\n    this.#action = action;\n    return this;\n  }\n\n  public build(): ActionByBuilder<T, Context<T>> {\n    if (!this.#action) {\n      throw new Error('Your action builder should includes an action.');\n    }\n\n    return {\n      actionName: this.name,\n      action: this.#action,\n      before: this.#before,\n      after: this.#after,\n      and: this.#and,\n      or: this.#or,\n    };\n  }\n}\n", "/*\n * It is not a good idea to re-export all of CAIP because if they have a breaking change, we will break as well.\n * It would be better to create an abstraction over them and export our own interface to ensure it is under our control.\n */\nexport * as CAIP from 'caip';\n\nexport { generateStoreId } from '../hub/helpers.js';\nexport * from './versions.js';\n", "import { AccountId } from 'caip';\n\nexport function isValidCaipAddress(address: string): boolean {\n  try {\n    AccountId.parse(address);\n    return true;\n  } catch {\n    return false;\n  }\n}\n", "import type {\n  Accounts,\n  AccountsWithActiveChain,\n} from './../../types/accounts.js';\nimport type { Context } from '../../hub/namespaces/mod.js';\n\nimport { isValidCaipAddress } from './helpers.js';\n\nexport function connectAndUpdateStateForSingleNetwork(\n  context: Context,\n  accounts: Accounts\n) {\n  if (!accounts.every(isValidCaipAddress)) {\n    throw new Error(\n      `Your provider should format account addresses in CAIP-10 format. Your provided accounts: ${accounts}`\n    );\n  }\n\n  const [, setState] = context.state();\n  setState('accounts', accounts);\n  setState('connected', true);\n  return accounts;\n}\n\nexport function connectAndUpdateStateForMultiNetworks(\n  context: Context,\n  accounts: AccountsWithActiveChain\n) {\n  if (!accounts.accounts.every(isValidCaipAddress)) {\n    throw new Error(\n      `Your provider should format account addresses in CAIP-10 format. Your provided accounts: ${accounts.accounts}`\n    );\n  }\n\n  const [, setState] = context.state();\n  setState('accounts', accounts.accounts);\n  setState('network', accounts.network);\n  setState('connected', true);\n  return accounts;\n}\n\nexport const recommended = [];\n", "import type { Context } from '../../hub/namespaces/mod.js';\n\nexport function intoConnecting(context: Context) {\n  const [, setState] = context.state();\n  setState('connecting', true);\n}\n\n// Please consider if you are going to add something here, make sure it works on all namespaces.\nexport const recommended = [['connect', intoConnecting] as const];\n", "import { recommended as commonRecommended } from '../common/before.js';\n\nexport const recommended = [...commonRecommended];\n", "import type { TronActions } from './types.js';\n\nimport { ActionBuilder } from '../../mod.js';\nimport { intoConnectionFinished } from '../common/after.js';\nimport { connectAndUpdateStateForSingleNetwork } from '../common/and.js';\nimport { intoConnecting } from '../common/before.js';\n\nexport const connect = () =>\n  new ActionBuilder<TronActions, 'connect'>('connect')\n    .and(connectAndUpdateStateForSingleNetwork)\n    .before(intoConnecting)\n    .after(intoConnectionFinished);\n\nexport const canEagerConnect = () =>\n  new ActionBuilder<TronActions, 'canEagerConnect'>('canEagerConnect');\n\nexport const getAllowance = () =>\n  new ActionBuilder<TronActions, 'getAllowance'>('getAllowance');\n\nexport const buildApproveTransaction = () =>\n  new ActionBuilder<TronActions, 'buildApproveTransaction'>(\n    'buildApproveTransaction'\n  );\n\nexport const getTransactionInfo = () =>\n  new ActionBuilder<TronActions, 'getTransactionInfo'>('getTransactionInfo');\n"],
+  "mappings": "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",
+  "names": ["actions_exports", "__export", "buildApproveTransaction", "getAllowance", "getTransactionInfo", "recommended", "disconnect", "context", "setState", "__name", "recommended", "CAIP_NAMESPACE", "CAIP_TRON_CHAIN_ID", "APPROVE_FUNCTION_SELECTOR", "utils_exports", "__export", "buildApprovePayload", "formatAccountsToCAIP", "getTronWeb", "hexAddressToTronBase58", "isTronNamespace", "getNamespaceFromCaip2ChainId", "AccountId", "isTronNamespace", "caip2ChainId", "getNamespaceFromCaip2ChainId", "CAIP_NAMESPACE", "__name", "buildApprovePayload", "transaction", "feeLimit", "call", "APPROVE_FUNCTION_SELECTOR", "getTronWeb", "instance", "tronInstance", "TRON_HEX_ADDRESS_PREFIX", "hexAddressToTronBase58", "tronWeb", "address", "tronHex", "formatAccountsToCAIP", "accounts", "account", "AccountId", "CAIP_TRON_CHAIN_ID", "recommended", "getAllowance", "instance", "_context", "params", "tronWeb", "getTronWeb", "owner", "hexAddressToTronBase58", "token", "spender", "result", "constant_result", "__name", "buildApproveTransaction", "feeLimit", "transaction", "APPROVE_FUNCTION_SELECTOR", "buildApprovePayload", "getTransactionInfo", "txID", "after_exports", "__export", "recommended", "intoConnectionFinished", "context", "setState", "__name", "recommended", "recommended", "and_exports", "__export", "recommended", "createZustandStore", "produce", "produce", "ActionBuilder", "__name", "#and", "#or", "#after", "#before", "#action", "name", "action", "CAIP", "AccountId", "isValidCaipAddress", "address", "AccountId", "__name", "connectAndUpdateStateForSingleNetwork", "context", "accounts", "isValidCaipAddress", "setState", "__name", "intoConnecting", "context", "setState", "__name", "recommended", "recommended", "connectAndUpdateStateForSingleNetwork", "before_exports", "__export", "recommended", "recommended", "builders_exports", "__export", "buildApproveTransaction", "canEagerConnect", "connect", "getAllowance", "getTransactionInfo", "connect", "__name", "ActionBuilder", "connectAndUpdateStateForSingleNetwork", "intoConnecting", "intoConnectionFinished", "canEagerConnect", "getAllowance", "buildApproveTransaction", "getTransactionInfo"]
 }

package/dist/namespaces/tron/types.d.ts

@@ -3,6 +3,153 @@ import type { AutoImplementedActionsByRecommended, CommonActions } from '../comm
 export interface TronActions extends AutoImplementedActionsByRecommended, CommonActions {
     connect: () => Promise<Accounts>;
     canEagerConnect: () => Promise<boolean>;
+    /** Reads the current TRC-20 allowance, returned as a decimal string. */
+    getAllowance: (params: TronAllowanceParams) => Promise<string>;
+    /** Builds (via the node) a ready-to-sign TRC-20 `approve` transaction. */
+    buildApproveTransaction: (params: TronApproveParams) => Promise<TronBuiltTransaction>;
+    /** Reads a transaction's on-chain info (fields are empty while unconfirmed). */
+    getTransactionInfo: (txID: string) => Promise<TronTransactionInfo>;
+}
+/** Addresses are provided in 0x-hex form and converted to Tron form internally. */
+export type TronAllowanceParams = {
+    token: string;
+    owner: string;
+    spender: string;
+};
+export type TronApproveParams = {
+    token: string;
+    owner: string;
+    spender: string;
+    /** Amount to approve, as an integer string in the token's smallest unit. */
+    amount: string;
+    /** Fee limit in SUN; defaults to DEFAULT_APPROVE_FEE_LIMIT when omitted. */
+    feeLimit?: number;
+};
+/**
+ * The focused TronWeb surface the repo calls — both these namespace actions and
+ * the Tron signer, which is handed this same injected instance. `tronweb` is not
+ * a repo dependency (wallets use the wallet-injected instance), so we type only
+ * the methods we use rather than pulling the package's declarations.
+ *
+ * @see https://tronweb.network/docu/docs/intro TronWeb API reference — used
+ * here: `transactionBuilder.triggerConstantContract` / `triggerSmartContract`,
+ * `trx.getUnconfirmedTransactionInfo` / `sign` / `signMessageV2` /
+ * `sendRawTransaction`, and `address.fromHex`.
+ */
+export interface TronWebApi {
+    defaultAddress: {
+        base58: string;
+    };
+    transactionBuilder: {
+        triggerConstantContract: (contractAddress: string, functionSelector: string, options: TriggerOptions, parameters: TriggerParameter[], issuerAddress: string) => Promise<TriggerConstantContractResult>;
+        triggerSmartContract: (contractAddress: string, functionSelector: string, options: TriggerOptions, parameters: TriggerParameter[], issuerAddress: string) => Promise<TriggerSmartContractResult>;
+    };
+    trx: {
+        /**
+         * Full-node lookup that returns the info as soon as the tx is in a block
+         * (~3s). `getTransactionInfo` queries the solidity node instead and returns
+         * an empty object until the tx solidifies (~60s), so it is unsuitable for
+         * promptly resolving approve-transaction status.
+         */
+        getUnconfirmedTransactionInfo: (txID: string) => Promise<TronTransactionInfo>;
+        signMessageV2: (message: string) => Promise<string>;
+        sign: (transaction: object) => Promise<TronSignedTransaction>;
+        sendRawTransaction: (signedTransaction: TronSignedTransaction) => Promise<TronBroadcastReceipt>;
+    };
+    address: {
+        fromHex: (hexAddress: string) => string;
+    };
+}
+/** A contract-call parameter, e.g. `{ type: 'address', value: 'T...' }`. */
+export type TriggerParameter = {
+    type: string;
+    value: string;
+};
+export type TriggerOptions = {
+    feeLimit?: number;
+};
+/**
+ * Describes the contract call that produced a transaction.
+ *
+ * Wallets that let the user edit an approve amount rebuild the transaction from
+ * this rather than decoding `raw_data`, so it has to carry everything needed to
+ * re-issue the call. Server-built transactions include it; TronWeb's
+ * `transactionBuilder` does not, so the Tron namespace adds it.
+ */
+export interface TronTransactionPayload {
+    /** The kind of client the call came from; server-built transactions use 'WEB'. */
+    type: string;
+    owner_address: string;
+    call_value: number;
+    contract_address: string;
+    fee_limit: number;
+    function_selector: string;
+    /** The ABI-encoded arguments, i.e. the call data without its selector. */
+    parameter: string;
+    chainType: string | null;
+}
+/**
+ * A transaction as returned by TronWeb's `transactionBuilder` — the subset of
+ * fields the Tron signer consumes to sign and broadcast.
+ */
+export interface TronBuiltTransaction {
+    txID: string;
+    raw_data: unknown;
+    raw_data_hex: string;
+    visible?: boolean;
+    __payload__?: TronTransactionPayload;
+}
+/** The contract call inside a built transaction's `raw_data`. */
+export interface TronRawDataContract {
+    parameter?: {
+        value?: {
+            data?: string;
+            owner_address?: string;
+            contract_address?: string;
+        };
+    };
+}
+/** A transaction after signing, carrying the id it was signed under. */
+export interface TronSignedTransaction {
+    txID?: string;
+}
+/**
+ * The response to a broadcast. Wallet-injected TronWeb instances disagree on
+ * where the transaction id lives, so both known shapes are optional here.
+ */
+export interface TronBroadcastReceipt {
+    txid?: string;
+    transaction?: {
+        txID?: string;
+    };
+}
+export interface TriggerConstantContractResult {
+    result: {
+        result: boolean;
+    };
+    /** ABI-encoded return words; `constant_result[0]` holds the allowance. */
+    constant_result: string[];
+    transaction: TronBuiltTransaction;
+}
+export interface TriggerSmartContractResult {
+    result: {
+        result: boolean;
+    };
+    transaction: TronBuiltTransaction;
+}
+/** The receipt embedded in a Tron transaction's on-chain info. */
+export interface TronTransactionReceipt {
+    /** e.g. 'SUCCESS' | 'REVERT' | 'OUT_OF_ENERGY'; absent while unconfirmed. */
+    result?: string;
+}
+export interface TronTransactionInfo {
+    id?: string;
+    blockNumber?: number;
+    receipt?: TronTransactionReceipt;
+}
+/** The injected Tron provider instance, which exposes a TronWeb instance. */
+export interface ProviderAPI {
+    [key: string]: any;
+    tronWeb: TronWebApi;
 }
-export type ProviderAPI = Record<string, any>;
 //# sourceMappingURL=types.d.ts.map

package/dist/namespaces/tron/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/namespaces/tron/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EACV,mCAAmC,EACnC,aAAa,EACd,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,WACf,SAAQ,mCAAmC,EACzC,aAAa;IACf,OAAO,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,eAAe,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC;AAGD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/namespaces/tron/types.ts"],"names":[],"mappings":"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"}

package/dist/namespaces/tron/utils.d.ts

@@ -1,3 +1,23 @@
+import type { ProviderAPI, TronBuiltTransaction, TronTransactionPayload, TronWebApi } from './types.js';
 export declare function isTronNamespace(caip2ChainId: string): boolean;
+/**
+ * Describes a built approve call the way a server-built transaction does.
+ *
+ * Wallets that let the user choose the allowance rebuild the transaction from
+ * `__payload__` instead of decoding `raw_data`. TronWeb's `transactionBuilder`
+ * leaves it out, and given an empty one TronLink cannot re-issue the call and
+ * reports "Modification failed", so the approve can never be signed there.
+ *
+ * The values are read back out of the built transaction rather than recomputed,
+ * so they cannot drift from what was actually built and signed.
+ */
+export declare function buildApprovePayload(transaction: TronBuiltTransaction, feeLimit: number): TronTransactionPayload | undefined;
+/** The wallet-injected TronWeb instance, or a readable error when absent. */
+export declare function getTronWeb(instance: () => ProviderAPI | undefined): TronWebApi;
+/**
+ * Prerequisite addresses arrive in 0x-hex (EVM-style) form; TronWeb expects a
+ * Tron address. Convert `0x<20-bytes>` → `41<20-bytes>` → Base58.
+ */
+export declare function hexAddressToTronBase58(tronWeb: TronWebApi, address: string): string;
 export declare function formatAccountsToCAIP(accounts: string[]): `${string}:${string}:${string}`[];
 //# sourceMappingURL=utils.d.ts.map

package/dist/namespaces/tron/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/namespaces/tron/utils.ts"],"names":[],"mappings":"AAOA,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,qCAWtD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/namespaces/tron/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EAEpB,sBAAsB,EACtB,UAAU,EACX,MAAM,YAAY,CAAC;AAapB,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,oBAAoB,EACjC,QAAQ,EAAE,MAAM,GACf,sBAAsB,GAAG,SAAS,CAoBpC;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,WAAW,GAAG,SAAS,GACtC,UAAU,CAMZ;AAKD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CAGR;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,qCAWtD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rango-dev/wallets-core",
-  "version": "0.62.1",
+  "version": "0.62.2-next.1",
   "license": "MIT",
   "type": "module",
   "source": "./src/mod.ts",
@@ -82,11 +82,11 @@
     "xrpl": "^4.2.0"
   },
   "dependencies": {
-    "@hub3js/std": "^0.4.0",
+    "@hub3js/std": "^0.5.0",
     "@stellar/stellar-sdk": "^15.0.1",
     "caip": "^1.1.1",
     "immer": "^10.0.4",
-    "rango-types": "^0.5.0",
+    "rango-types": "^0.6.0",
     "zustand": "^4.5.2"
   },
   "devDependencies": {

package/src/namespaces/tron/actions.ts

@@ -1,3 +1,106 @@
+import type { ProviderAPI, TronActions } from './types.js';
+import type { Context } from '../../hub/namespaces/mod.js';
+import type { FunctionWithContext } from '../../types/actions.js';
+
 import { recommended as commonRecommended } from '../common/actions.js';
 
+import {
+  APPROVE_FUNCTION_SELECTOR,
+  DEFAULT_APPROVE_FEE_LIMIT,
+} from './constants.js';
+import {
+  buildApprovePayload,
+  getTronWeb,
+  hexAddressToTronBase58,
+} from './utils.js';
+
 export const recommended = [...commonRecommended];
+
+/**
+ * Reads a TRC-20 `allowance(owner, spender)` via a constant contract call and
+ * returns it as a decimal string.
+ */
+export function getAllowance(
+  instance: () => ProviderAPI | undefined
+): FunctionWithContext<TronActions['getAllowance'], Context> {
+  return async (_context, params) => {
+    const tronWeb = getTronWeb(instance);
+    const owner = hexAddressToTronBase58(tronWeb, params.owner);
+    const token = hexAddressToTronBase58(tronWeb, params.token);
+    const spender = hexAddressToTronBase58(tronWeb, params.spender);
+
+    const { result, constant_result } =
+      await tronWeb.transactionBuilder.triggerConstantContract(
+        token,
+        'allowance(address,address)',
+        {},
+        [
+          { type: 'address', value: owner },
+          { type: 'address', value: spender },
+        ],
+        owner
+      );
+
+    if (!result?.result || !constant_result?.length) {
+      throw new Error('Failed to read the TRC-20 allowance.');
+    }
+
+    return BigInt(`0x${constant_result[0]}`).toString();
+  };
+}
+
+/**
+ * Builds (via the node) a ready-to-sign `approve(spender, amount)` transaction
+ * on the TRC-20 token contract.
+ *
+ * The transaction carries TronWeb's default 60s expiration, which is the same
+ * window server-built approvals use.
+ */
+export function buildApproveTransaction(
+  instance: () => ProviderAPI | undefined
+): FunctionWithContext<TronActions['buildApproveTransaction'], Context> {
+  return async (_context, params) => {
+    const tronWeb = getTronWeb(instance);
+    const owner = hexAddressToTronBase58(tronWeb, params.owner);
+    const token = hexAddressToTronBase58(tronWeb, params.token);
+    const spender = hexAddressToTronBase58(tronWeb, params.spender);
+
+    const feeLimit = params.feeLimit ?? DEFAULT_APPROVE_FEE_LIMIT;
+    const { result, transaction } =
+      await tronWeb.transactionBuilder.triggerSmartContract(
+        token,
+        APPROVE_FUNCTION_SELECTOR,
+        { feeLimit },
+        [
+          { type: 'address', value: spender },
+          { type: 'uint256', value: params.amount },
+        ],
+        owner
+      );
+
+    if (!result?.result) {
+      throw new Error('Failed to build the TRC-20 approve transaction.');
+    }
+
+    /*
+     * `transactionBuilder` returns only the consensus fields. A server-built
+     * transaction also carries `__payload__`, which wallets use to re-issue the
+     * call when the user edits the allowance, so add it here too.
+     */
+    return {
+      ...transaction,
+      __payload__: buildApprovePayload(transaction, feeLimit),
+    };
+  };
+}
+
+/** Reads a transaction's on-chain info (empty while the tx is unconfirmed). */
+export function getTransactionInfo(
+  instance: () => ProviderAPI | undefined
+): FunctionWithContext<TronActions['getTransactionInfo'], Context> {
+  return async (_context, txID) => {
+    const tronWeb = getTronWeb(instance);
+    // Full node (not solidity), so the info is available right after inclusion.
+    return tronWeb.trx.getUnconfirmedTransactionInfo(txID);
+  };
+}

package/src/namespaces/tron/builders.ts

@@ -13,3 +13,14 @@ export const connect = () =>
 
 export const canEagerConnect = () =>
   new ActionBuilder<TronActions, 'canEagerConnect'>('canEagerConnect');
+
+export const getAllowance = () =>
+  new ActionBuilder<TronActions, 'getAllowance'>('getAllowance');
+
+export const buildApproveTransaction = () =>
+  new ActionBuilder<TronActions, 'buildApproveTransaction'>(
+    'buildApproveTransaction'
+  );
+
+export const getTransactionInfo = () =>
+  new ActionBuilder<TronActions, 'getTransactionInfo'>('getTransactionInfo');

package/src/namespaces/tron/constants.ts

@@ -6,3 +6,18 @@
 // if the value needs to be change make sure you will update mapCaipNamespaceToLegacyNetworkName as well
 export const CAIP_NAMESPACE = 'tron';
 export const CAIP_TRON_CHAIN_ID = 'tron';
+
+/**
+ * Default fee limit (in SUN) for a client-built TRC-20 approve transaction.
+ * 250 TRX — matches the value the backend used for server-built approvals.
+ */
+export const DEFAULT_APPROVE_FEE_LIMIT = 250_000_000;
+
+/** The TRC-20 call the approve prerequisite issues. */
+export const APPROVE_FUNCTION_SELECTOR = 'approve(address,uint256)';
+
+/**
+ * Length in hex characters of the function selector that prefixes a call's
+ * data: 4 bytes, two characters each.
+ */
+export const FUNCTION_SELECTOR_HEX_LENGTH = 8;

package/src/namespaces/tron/types.ts

@@ -9,7 +9,173 @@ export interface TronActions
     CommonActions {
   connect: () => Promise<Accounts>;
   canEagerConnect: () => Promise<boolean>;
+  /** Reads the current TRC-20 allowance, returned as a decimal string. */
+  getAllowance: (params: TronAllowanceParams) => Promise<string>;
+  /** Builds (via the node) a ready-to-sign TRC-20 `approve` transaction. */
+  buildApproveTransaction: (
+    params: TronApproveParams
+  ) => Promise<TronBuiltTransaction>;
+  /** Reads a transaction's on-chain info (fields are empty while unconfirmed). */
+  getTransactionInfo: (txID: string) => Promise<TronTransactionInfo>;
 }
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export type ProviderAPI = Record<string, any>;
+/** Addresses are provided in 0x-hex form and converted to Tron form internally. */
+export type TronAllowanceParams = {
+  token: string;
+  owner: string;
+  spender: string;
+};
+
+export type TronApproveParams = {
+  token: string;
+  owner: string;
+  spender: string;
+  /** Amount to approve, as an integer string in the token's smallest unit. */
+  amount: string;
+  /** Fee limit in SUN; defaults to DEFAULT_APPROVE_FEE_LIMIT when omitted. */
+  feeLimit?: number;
+};
+
+/**
+ * The focused TronWeb surface the repo calls — both these namespace actions and
+ * the Tron signer, which is handed this same injected instance. `tronweb` is not
+ * a repo dependency (wallets use the wallet-injected instance), so we type only
+ * the methods we use rather than pulling the package's declarations.
+ *
+ * @see https://tronweb.network/docu/docs/intro TronWeb API reference — used
+ * here: `transactionBuilder.triggerConstantContract` / `triggerSmartContract`,
+ * `trx.getUnconfirmedTransactionInfo` / `sign` / `signMessageV2` /
+ * `sendRawTransaction`, and `address.fromHex`.
+ */
+export interface TronWebApi {
+  defaultAddress: { base58: string };
+  transactionBuilder: {
+    triggerConstantContract: (
+      contractAddress: string,
+      functionSelector: string,
+      options: TriggerOptions,
+      parameters: TriggerParameter[],
+      issuerAddress: string
+    ) => Promise<TriggerConstantContractResult>;
+    triggerSmartContract: (
+      contractAddress: string,
+      functionSelector: string,
+      options: TriggerOptions,
+      parameters: TriggerParameter[],
+      issuerAddress: string
+    ) => Promise<TriggerSmartContractResult>;
+  };
+  trx: {
+    /**
+     * Full-node lookup that returns the info as soon as the tx is in a block
+     * (~3s). `getTransactionInfo` queries the solidity node instead and returns
+     * an empty object until the tx solidifies (~60s), so it is unsuitable for
+     * promptly resolving approve-transaction status.
+     */
+    getUnconfirmedTransactionInfo: (
+      txID: string
+    ) => Promise<TronTransactionInfo>;
+    signMessageV2: (message: string) => Promise<string>;
+    sign: (transaction: object) => Promise<TronSignedTransaction>;
+    sendRawTransaction: (
+      signedTransaction: TronSignedTransaction
+    ) => Promise<TronBroadcastReceipt>;
+  };
+  address: {
+    fromHex: (hexAddress: string) => string;
+  };
+}
+
+/** A contract-call parameter, e.g. `{ type: 'address', value: 'T...' }`. */
+export type TriggerParameter = { type: string; value: string };
+export type TriggerOptions = { feeLimit?: number };
+
+/**
+ * Describes the contract call that produced a transaction.
+ *
+ * Wallets that let the user edit an approve amount rebuild the transaction from
+ * this rather than decoding `raw_data`, so it has to carry everything needed to
+ * re-issue the call. Server-built transactions include it; TronWeb's
+ * `transactionBuilder` does not, so the Tron namespace adds it.
+ */
+export interface TronTransactionPayload {
+  /** The kind of client the call came from; server-built transactions use 'WEB'. */
+  type: string;
+  owner_address: string;
+  call_value: number;
+  contract_address: string;
+  fee_limit: number;
+  function_selector: string;
+  /** The ABI-encoded arguments, i.e. the call data without its selector. */
+  parameter: string;
+  chainType: string | null;
+}
+
+/**
+ * A transaction as returned by TronWeb's `transactionBuilder` — the subset of
+ * fields the Tron signer consumes to sign and broadcast.
+ */
+export interface TronBuiltTransaction {
+  txID: string;
+  raw_data: unknown;
+  raw_data_hex: string;
+  visible?: boolean;
+  __payload__?: TronTransactionPayload;
+}
+
+/** The contract call inside a built transaction's `raw_data`. */
+export interface TronRawDataContract {
+  parameter?: {
+    value?: {
+      data?: string;
+      owner_address?: string;
+      contract_address?: string;
+    };
+  };
+}
+
+/** A transaction after signing, carrying the id it was signed under. */
+export interface TronSignedTransaction {
+  txID?: string;
+}
+
+/**
+ * The response to a broadcast. Wallet-injected TronWeb instances disagree on
+ * where the transaction id lives, so both known shapes are optional here.
+ */
+export interface TronBroadcastReceipt {
+  txid?: string;
+  transaction?: { txID?: string };
+}
+
+export interface TriggerConstantContractResult {
+  result: { result: boolean };
+  /** ABI-encoded return words; `constant_result[0]` holds the allowance. */
+  constant_result: string[];
+  transaction: TronBuiltTransaction;
+}
+
+export interface TriggerSmartContractResult {
+  result: { result: boolean };
+  transaction: TronBuiltTransaction;
+}
+
+/** The receipt embedded in a Tron transaction's on-chain info. */
+export interface TronTransactionReceipt {
+  /** e.g. 'SUCCESS' | 'REVERT' | 'OUT_OF_ENERGY'; absent while unconfirmed. */
+  result?: string;
+}
+
+export interface TronTransactionInfo {
+  id?: string;
+  blockNumber?: number;
+  receipt?: TronTransactionReceipt;
+}
+
+/** The injected Tron provider instance, which exposes a TronWeb instance. */
+export interface ProviderAPI {
+  // Providers attach extra members (request, ready, …) we don't type here.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  [key: string]: any;
+  tronWeb: TronWebApi;
+}

package/src/namespaces/tron/utils.ts

@@ -1,14 +1,88 @@
+import type {
+  ProviderAPI,
+  TronBuiltTransaction,
+  TronRawDataContract,
+  TronTransactionPayload,
+  TronWebApi,
+} from './types.js';
 import type { CaipAccount } from '../common/mod.js';
 
 import { getNamespaceFromCaip2ChainId } from '@hub3js/std/utils';
 import { AccountId } from 'caip';
 
-import { CAIP_NAMESPACE, CAIP_TRON_CHAIN_ID } from './constants.js';
+import {
+  APPROVE_FUNCTION_SELECTOR,
+  CAIP_NAMESPACE,
+  CAIP_TRON_CHAIN_ID,
+  FUNCTION_SELECTOR_HEX_LENGTH,
+} from './constants.js';
 
 export function isTronNamespace(caip2ChainId: string): boolean {
   return getNamespaceFromCaip2ChainId(caip2ChainId) === CAIP_NAMESPACE;
 }
 
+/**
+ * Describes a built approve call the way a server-built transaction does.
+ *
+ * Wallets that let the user choose the allowance rebuild the transaction from
+ * `__payload__` instead of decoding `raw_data`. TronWeb's `transactionBuilder`
+ * leaves it out, and given an empty one TronLink cannot re-issue the call and
+ * reports "Modification failed", so the approve can never be signed there.
+ *
+ * The values are read back out of the built transaction rather than recomputed,
+ * so they cannot drift from what was actually built and signed.
+ */
+export function buildApprovePayload(
+  transaction: TronBuiltTransaction,
+  feeLimit: number
+): TronTransactionPayload | undefined {
+  const rawData = transaction.raw_data as
+    | { contract?: TronRawDataContract[] }
+    | undefined;
+  const call = rawData?.contract?.[0]?.parameter?.value;
+
+  if (!call?.data || !call.owner_address || !call.contract_address) {
+    return undefined;
+  }
+
+  return {
+    type: 'WEB',
+    owner_address: call.owner_address,
+    call_value: 0,
+    contract_address: call.contract_address,
+    fee_limit: feeLimit,
+    function_selector: APPROVE_FUNCTION_SELECTOR,
+    parameter: call.data.slice(FUNCTION_SELECTOR_HEX_LENGTH),
+    chainType: null,
+  };
+}
+
+/** The wallet-injected TronWeb instance, or a readable error when absent. */
+export function getTronWeb(
+  instance: () => ProviderAPI | undefined
+): TronWebApi {
+  const tronInstance = instance();
+  if (!tronInstance?.tronWeb) {
+    throw new Error('Tron is not available on your wallet.');
+  }
+  return tronInstance.tronWeb;
+}
+
+/** Tron mainnet address prefix byte (0x41) in hex. */
+const TRON_HEX_ADDRESS_PREFIX = '41';
+
+/**
+ * Prerequisite addresses arrive in 0x-hex (EVM-style) form; TronWeb expects a
+ * Tron address. Convert `0x<20-bytes>` → `41<20-bytes>` → Base58.
+ */
+export function hexAddressToTronBase58(
+  tronWeb: TronWebApi,
+  address: string
+): string {
+  const tronHex = TRON_HEX_ADDRESS_PREFIX + address.replace(/^0x/, '');
+  return tronWeb.address.fromHex(tronHex);
+}
+
 export function formatAccountsToCAIP(accounts: string[]) {
   return accounts.map(
     (account) =>