@latticexyz/common 2.0.0-next.10 → 2.0.0-next.11

package/dist/chains.js

@@ -1,2 +1,2 @@
-var t={name:"Lattice Testnet",id:4242,network:"lattice-testnet",nativeCurrency:{decimals:18,name:"Ether",symbol:"ETH"},rpcUrls:{default:{http:["https://follower.testnet-chain.linfra.xyz"],webSocket:["wss://follower.testnet-chain.linfra.xyz"]},public:{http:["https://follower.testnet-chain.linfra.xyz"],webSocket:["wss://follower.testnet-chain.linfra.xyz"]}},blockExplorers:{otterscan:{name:"Otterscan",url:"https://explorer.testnet-chain.linfra.xyz"},default:{name:"Otterscan",url:"https://explorer.testnet-chain.linfra.xyz"}},faucetUrl:"https://faucet.testnet-mud-services.linfra.xyz"};import{foundry as e}from"viem/chains";var r={...e,fees:{defaultPriorityFee:0n}};export{t as latticeTestnet,r as mudFoundry};
+var t={name:"Lattice Testnet",id:4242,network:"lattice-testnet",nativeCurrency:{decimals:18,name:"Ether",symbol:"ETH"},rpcUrls:{default:{http:["https://follower.testnet-chain.linfra.xyz"],webSocket:["wss://follower.testnet-chain.linfra.xyz"]},public:{http:["https://follower.testnet-chain.linfra.xyz"],webSocket:["wss://follower.testnet-chain.linfra.xyz"]}},blockExplorers:{default:{name:"Otterscan",url:"https://explorer.testnet-chain.linfra.xyz"}},faucetUrl:"https://faucet.testnet-mud-services.linfra.xyz"};import{foundry as e}from"viem/chains";var r={...e,fees:{defaultPriorityFee:()=>0n}};export{t as latticeTestnet,r as mudFoundry};
 //# sourceMappingURL=chains.js.map

package/dist/chains.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/chains/latticeTestnet.ts","../src/chains/mudFoundry.ts"],"sourcesContent":["import type { MUDChain } from \"./types\";\n\nexport const latticeTestnet = {\n  name: \"Lattice Testnet\",\n  id: 4242,\n  network: \"lattice-testnet\",\n  nativeCurrency: { decimals: 18, name: \"Ether\", symbol: \"ETH\" },\n  rpcUrls: {\n    default: {\n      http: [\"https://follower.testnet-chain.linfra.xyz\"],\n      webSocket: [\"wss://follower.testnet-chain.linfra.xyz\"],\n    },\n    public: {\n      http: [\"https://follower.testnet-chain.linfra.xyz\"],\n      webSocket: [\"wss://follower.testnet-chain.linfra.xyz\"],\n    },\n  },\n  blockExplorers: {\n    otterscan: {\n      name: \"Otterscan\",\n      url: \"https://explorer.testnet-chain.linfra.xyz\",\n    },\n    default: {\n      name: \"Otterscan\",\n      url: \"https://explorer.testnet-chain.linfra.xyz\",\n    },\n  },\n  faucetUrl: \"https://faucet.testnet-mud-services.linfra.xyz\",\n} as const satisfies MUDChain;\n","import { foundry } from \"viem/chains\";\nimport { MUDChain } from \"./types\";\n\nexport const mudFoundry = {\n  ...foundry,\n  fees: {\n    defaultPriorityFee: 0n,\n  },\n} as const satisfies MUDChain;\n"],"mappings":"AAEO,IAAMA,EAAiB,CAC5B,KAAM,kBACN,GAAI,KACJ,QAAS,kBACT,eAAgB,CAAE,SAAU,GAAI,KAAM,QAAS,OAAQ,KAAM,EAC7D,QAAS,CACP,QAAS,CACP,KAAM,CAAC,2CAA2C,EAClD,UAAW,CAAC,yCAAyC,CACvD,EACA,OAAQ,CACN,KAAM,CAAC,2CAA2C,EAClD,UAAW,CAAC,yCAAyC,CACvD,CACF,EACA,eAAgB,CACd,UAAW,CACT,KAAM,YACN,IAAK,2CACP,EACA,QAAS,CACP,KAAM,YACN,IAAK,2CACP,CACF,EACA,UAAW,gDACb,EC5BA,OAAS,WAAAC,MAAe,cAGjB,IAAMC,EAAa,CACxB,GAAGD,EACH,KAAM,CACJ,mBAAoB,EACtB,CACF","names":["latticeTestnet","foundry","mudFoundry"]}
+{"version":3,"sources":["../src/chains/latticeTestnet.ts","../src/chains/mudFoundry.ts"],"sourcesContent":["import type { MUDChain } from \"./types\";\n\nexport const latticeTestnet = {\n  name: \"Lattice Testnet\",\n  id: 4242,\n  network: \"lattice-testnet\",\n  nativeCurrency: { decimals: 18, name: \"Ether\", symbol: \"ETH\" },\n  rpcUrls: {\n    default: {\n      http: [\"https://follower.testnet-chain.linfra.xyz\"],\n      webSocket: [\"wss://follower.testnet-chain.linfra.xyz\"],\n    },\n    public: {\n      http: [\"https://follower.testnet-chain.linfra.xyz\"],\n      webSocket: [\"wss://follower.testnet-chain.linfra.xyz\"],\n    },\n  },\n  blockExplorers: {\n    default: {\n      name: \"Otterscan\",\n      url: \"https://explorer.testnet-chain.linfra.xyz\",\n    },\n  },\n  faucetUrl: \"https://faucet.testnet-mud-services.linfra.xyz\",\n} as const satisfies MUDChain;\n","import { foundry } from \"viem/chains\";\nimport { MUDChain } from \"./types\";\n\nexport const mudFoundry = {\n  ...foundry,\n  fees: {\n    // This is intentionally defined as a function as a workaround for https://github.com/wagmi-dev/viem/pull/1280\n    defaultPriorityFee: () => 0n,\n  },\n} as const satisfies MUDChain;\n"],"mappings":"AAEO,IAAMA,EAAiB,CAC5B,KAAM,kBACN,GAAI,KACJ,QAAS,kBACT,eAAgB,CAAE,SAAU,GAAI,KAAM,QAAS,OAAQ,KAAM,EAC7D,QAAS,CACP,QAAS,CACP,KAAM,CAAC,2CAA2C,EAClD,UAAW,CAAC,yCAAyC,CACvD,EACA,OAAQ,CACN,KAAM,CAAC,2CAA2C,EAClD,UAAW,CAAC,yCAAyC,CACvD,CACF,EACA,eAAgB,CACd,QAAS,CACP,KAAM,YACN,IAAK,2CACP,CACF,EACA,UAAW,gDACb,ECxBA,OAAS,WAAAC,MAAe,cAGjB,IAAMC,EAAa,CACxB,GAAGD,EACH,KAAM,CAEJ,mBAAoB,IAAM,EAC5B,CACF","names":["latticeTestnet","foundry","mudFoundry"]}

package/dist/index.js

@@ -1,2 +1,2 @@
-import{privateKeyToAccount as k}from"viem/accounts";function L(e){return{...k(e)}}import{getContract as E}from"viem";import $ from"p-retry";import{BaseError as I,NonceTooHighError as M,NonceTooLowError as O}from"viem";import v from"debug";var m=v("mud:common");var P=m.extend("createNonceManager");function w({publicClient:e,address:t,blockTag:r}){let n={current:-1},o=typeof BroadcastChannel<"u"?new BroadcastChannel(`mud:createNonceManager:${e.chain?.id}:${t}`):null;o&&o.addEventListener("message",a=>{let p=JSON.parse(a.data);P("got nonce from broadcast channel",p),n.current=p});function c(){return n.current>=0}function l(){if(!c())throw new Error("call resetNonce before using nextNonce");let a=n.current++;return o?.postMessage(JSON.stringify(n.current)),a}async function u(){let a=await e.getTransactionCount({address:t,blockTag:r});n.current=a,o?.postMessage(JSON.stringify(n.current)),P("reset nonce to",n.current)}function y(a){return a instanceof I&&a.walk(p=>p instanceof O||p instanceof M)!=null}return{hasNonce:c,nextNonce:l,resetNonce:u,shouldResetNonce:y}}var d=m.extend("createContract");function S(e){let t=e.length&&Array.isArray(e[0]),r=t?e[0]:[],n=(t?e[1]:e[0])??{};return{args:r,options:n}}function ye({abi:e,address:t,publicClient:r,walletClient:n,onWrite:o}){let c=E({abi:e,address:t,publicClient:r,walletClient:n});if(c.write){let l=0,u=w({publicClient:r,address:n.account.address});c.write=new Proxy({},{get(y,a){async function p(s){if(s.gas)return d("gas provided, skipping simulate",a,s),s;d("simulating write",a,s);let{request:T}=await r.simulateContract({...s,account:s.account??n.account});return T}async function R(s){let T=await p(s);return await $(async()=>{u.hasNonce()||await u.resetNonce();let i=u.nextNonce();return d("calling write function with nonce",i,T),await n.writeContract({nonce:i,...T})},{retries:3,onFailedAttempt:async i=>{if(u.shouldResetNonce(i)){d("got nonce error, retrying",i),await u.resetNonce();return}throw i}})}return(...s)=>{let T=`${n.chain.id}:${n.account.address}:${l++}`,{args:i,options:W}=S(s),A={address:t,abi:e,functionName:a,args:i,...W},h=R(A);return o?.({id:T,request:A,result:h}),h}}})}return c}import{generatePrivateKey as B,privateKeyToAccount as H}from"viem/accounts";import{isHex as G}from"viem";function q(e,t){if(!G(e))throw console.error("Private key found in cache is not valid hex",{privateKey:e,cacheKey:t}),new Error(`Private key found in cache (${t}) is not valid hex`);H(e)}function He(e="mud:burnerWallet"){let t=localStorage.getItem(e);if(t!=null)return q(t,e),t;let r=B();return console.log("New burner wallet created:",H(r)),localStorage.setItem(e,r),r}import{hexToString as C,sliceHex as b}from"viem";var N=["table","offchainTable","namespace","module","system"];import{stringToHex as f,concatHex as j}from"viem";var x={table:"tb",offchainTable:"ot",namespace:"ns",module:"md",system:"sy"};function ve(e){let t=x[e.type];return j([f(t,{size:2}),f(e.namespace.slice(0,14),{size:14}),f(e.name.slice(0,16),{size:16})])}var D=Object.fromEntries(Object.entries(x).map(([e,t])=>[t,e]));function z(e){let t=D[e];if(N.includes(t))return t}function Be(e){let t=C(b(e,0,2)).replace(/\0+$/,""),r=z(t),n=C(b(e,2,16)).replace(/\0+$/,""),o=C(b(e,16,32)).replace(/\0+$/,"");if(!r)throw new Error(`Unknown resource type: ${t}`);return{type:r,namespace:n,name:o}}function g(e,t,r){return`0x${e.replace(/^0x/,"").slice(t*2,r!=null?r*2:void 0).padEnd(((r??t)-t)*2,"0")}`}import{concatHex as J}from"viem";function Je(e,t,r=0,n="0x"){return J([g(e,0,t),n,g(e,t+r)])}import{keccak256 as K}from"viem";var U=m.extend("transportObserver");function Qe(e){return t=>{let r=e(t);return{...r,request:async o=>{if(o.method==="eth_sendRawTransaction"&&o.params instanceof Array){let c=o.params.map(l=>K(l));U("saw txs",c)}return r.request(o)}}}}export{L as createBurnerAccount,ye as createContract,w as createNonceManager,He as getBurnerPrivateKey,Be as hexToResourceId,g as readHex,ve as resourceIdToHex,x as resourceTypeIds,N as resourceTypes,Je as spliceHex,Qe as transportObserver};
+import{privateKeyToAccount as v}from"viem/accounts";function te(e){return{...v(e)}}import{BaseError as F,NonceTooHighError as B,NonceTooLowError as E}from"viem";import M from"debug";var p=M("mud:common");import{getAddress as k}from"viem";import{getChainId as I}from"viem/actions";async function m({client:e,address:n,blockTag:t}){return`mud:createNonceManager:${e.chain?.id??await I(e)}:${k(n)}:${t}`}import{getTransactionCount as $}from"viem/actions";var b=p.extend("createNonceManager");function y({client:e,address:n,blockTag:t="latest",broadcastChannelName:r}){let o={current:-1},a=null;typeof BroadcastChannel<"u"&&(r?Promise.resolve(r):m({client:e,address:n,blockTag:t})).then(s=>{a=new BroadcastChannel(s),a.addEventListener("message",O=>{let A=JSON.parse(O.data);b("got nonce from broadcast channel",A),o.current=A})});function c(){return o.current>=0}function T(){if(!c())throw new Error("call resetNonce before using nextNonce");let i=o.current++;return a?.postMessage(JSON.stringify(o.current)),i}async function d(){let i=await $(e,{address:n,blockTag:t});o.current=i,a?.postMessage(JSON.stringify(o.current)),b("reset nonce to",o.current)}function u(i){return i instanceof F&&i.walk(s=>s instanceof E||s instanceof B)!=null}return{hasNonce:c,nextNonce:T,resetNonce:d,shouldResetNonce:u}}import{getContract as D}from"viem";import{simulateContract as G,writeContract as S}from"viem/actions";import q from"p-retry";var N=new Map;async function w({client:e,address:n,blockTag:t="latest"}){let r=await m({client:e,address:n,blockTag:t}),o=N.get(r);if(o)return o;let a=y({client:e,address:n,blockTag:t});return N.set(r,a),a}import{parseAccount as _}from"viem/accounts";var l=p.extend("writeContract"),j=0;async function P(e,{onWrite:n,...t}){let r=t,o=r.account??e.account;if(!o)throw new Error("No account provided");let a=_(o),c=await w({client:e,address:a.address});async function T(){return r.gas?(l("gas provided, skipping simulate",r),r):(l("simulating write",r),(await G(e,{...r,account:a})).request)}async function d(){let i=await T();return await q(async()=>{c.hasNonce()||await c.resetNonce();let s=c.nextNonce();return l("calling write function with nonce",s,i),await S(e,{nonce:s,...i})},{retries:3,onFailedAttempt:async s=>{if(c.shouldResetNonce(s)){l("got nonce error, retrying",s),await c.resetNonce();return}throw s}})}let u=d();return n?.({id:`${j++}`,request:r,result:u}),u}function z(e){let n=e.length&&Array.isArray(e[0]),t=n?e[0]:[],r=(n?e[1]:e[0])??{};return{args:t,options:r}}function W({abi:e,address:n,publicClient:t,walletClient:r,onWrite:o}){let a=D({abi:e,address:n,publicClient:t,walletClient:r});return a.write&&(a.write=new Proxy({},{get(c,T){return(...d)=>{let{args:u,options:i}=z(d);return P(r,{abi:e,address:n,functionName:T,args:u,...i,onWrite:o})}}})),a}import{generatePrivateKey as J,privateKeyToAccount as H}from"viem/accounts";import{isHex as K}from"viem";function U(e,n){if(!K(e))throw console.error("Private key found in cache is not valid hex",{privateKey:e,cacheKey:n}),new Error(`Private key found in cache (${n}) is not valid hex`);H(e)}function Le(e="mud:burnerWallet"){let n=localStorage.getItem(e);if(n!=null)return U(n,e),n;let t=J();return console.log("New burner wallet created:",H(t)),localStorage.setItem(e,t),t}import{hexToString as x,sliceHex as g}from"viem";var R=["table","offchainTable","namespace","module","system"];import{stringToHex as C,concatHex as L}from"viem";var f={table:"tb",offchainTable:"ot",namespace:"ns",module:"md",system:"sy"};function Ze(e){let n=f[e.type];return L([C(n,{size:2}),C(e.namespace.slice(0,14),{size:14}),C(e.name.slice(0,16),{size:16})])}var Q=Object.fromEntries(Object.entries(f).map(([e,n])=>[n,e]));function V(e){let n=Q[e];if(R.includes(n))return n}function cn(e){let n=x(g(e,0,2)).replace(/\0+$/,""),t=V(n),r=x(g(e,2,16)).replace(/\0+$/,""),o=x(g(e,16,32)).replace(/\0+$/,"");if(!t)throw new Error(`Unknown resource type: ${n}`);return{type:t,namespace:r,name:o}}function h(e,n,t){return`0x${e.replace(/^0x/,"").slice(n*2,t!=null?t*2:void 0).padEnd(((t??n)-n)*2,"0")}`}import{concatHex as X}from"viem";function mn(e,n,t=0,r="0x"){return X([h(e,0,n),r,h(e,n+t)])}import{keccak256 as Y}from"viem";var Z=p.extend("transportObserver");function hn(e){return n=>{let t=e(n);return{...t,request:async o=>{if(o.method==="eth_sendRawTransaction"&&o.params instanceof Array){let a=o.params.map(c=>Y(c));Z("saw txs",a)}return t.request(o)}}}}var ee=W;export{te as createBurnerAccount,ee as createContract,y as createNonceManager,Le as getBurnerPrivateKey,W as getContract,w as getNonceManager,m as getNonceManagerId,cn as hexToResourceId,h as readHex,Ze as resourceIdToHex,f as resourceTypeIds,R as resourceTypes,mn as spliceHex,hn as transportObserver,P as writeContract};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/createBurnerAccount.ts","../src/createContract.ts","../src/createNonceManager.ts","../src/debug.ts","../src/getBurnerPrivateKey.ts","../src/hexToResourceId.ts","../src/resourceTypes.ts","../src/resourceIdToHex.ts","../src/readHex.ts","../src/spliceHex.ts","../src/transportObserver.ts"],"sourcesContent":["import { Account, Hex } from \"viem\";\nimport { privateKeyToAccount } from \"viem/accounts\";\n\nexport function createBurnerAccount(privateKey: Hex): Account {\n  const account = privateKeyToAccount(privateKey);\n  // We may override account features here\n  return {\n    ...account,\n  };\n}\n","import {\n  Abi,\n  Account,\n  Address,\n  Chain,\n  GetContractParameters,\n  GetContractReturnType,\n  Hex,\n  PublicClient,\n  SimulateContractParameters,\n  Transport,\n  WalletClient,\n  WriteContractParameters,\n  getContract,\n} from \"viem\";\nimport pRetry from \"p-retry\";\nimport { createNonceManager } from \"./createNonceManager\";\nimport { debug as parentDebug } from \"./debug\";\nimport { UnionOmit } from \"./type-utils/common\";\n\nconst debug = parentDebug.extend(\"createContract\");\n\n// copied from viem because this isn't exported\n// TODO: import from viem?\nfunction getFunctionParameters(values: [args?: readonly unknown[], options?: object]): {\n  args: readonly unknown[];\n  options: object;\n} {\n  const hasArgs = values.length && Array.isArray(values[0]);\n  const args = hasArgs ? values[0]! : [];\n  const options = (hasArgs ? values[1] : values[0]) ?? {};\n  return { args, options };\n}\n\nexport type ContractWrite = {\n  id: string;\n  request: WriteContractParameters;\n  result: Promise<Hex>;\n};\n\nexport type CreateContractOptions<\n  TTransport extends Transport,\n  TAddress extends Address,\n  TAbi extends Abi,\n  TChain extends Chain,\n  TAccount extends Account,\n  TPublicClient extends PublicClient<TTransport, TChain>,\n  TWalletClient extends WalletClient<TTransport, TChain, TAccount>\n> = Required<GetContractParameters<TTransport, TChain, TAccount, TAbi, TPublicClient, TWalletClient, TAddress>> & {\n  onWrite?: (write: ContractWrite) => void;\n};\n\nexport function createContract<\n  TTransport extends Transport,\n  TAddress extends Address,\n  TAbi extends Abi,\n  TChain extends Chain,\n  TAccount extends Account,\n  TPublicClient extends PublicClient<TTransport, TChain>,\n  TWalletClient extends WalletClient<TTransport, TChain, TAccount>\n>({\n  abi,\n  address,\n  publicClient,\n  walletClient,\n  onWrite,\n}: CreateContractOptions<\n  TTransport,\n  TAddress,\n  TAbi,\n  TChain,\n  TAccount,\n  TPublicClient,\n  TWalletClient\n>): GetContractReturnType<TAbi, TPublicClient, TWalletClient, TAddress> {\n  const contract = getContract<TTransport, TAddress, TAbi, TChain, TAccount, TPublicClient, TWalletClient>({\n    abi,\n    address,\n    publicClient,\n    walletClient,\n  }) as unknown as GetContractReturnType<Abi, PublicClient, WalletClient>;\n\n  if (contract.write) {\n    let nextWriteId = 0;\n    const nonceManager = createNonceManager({\n      publicClient: publicClient as PublicClient,\n      address: walletClient.account.address,\n    });\n\n    // Replace write calls with our own proxy. Implemented ~the same as viem, but adds better handling of nonces (via queue + retries).\n    contract.write = new Proxy(\n      {},\n      {\n        get(_, functionName: string): GetContractReturnType<Abi, PublicClient, WalletClient>[\"write\"][string] {\n          async function prepareWrite(\n            options: WriteContractParameters\n          ): Promise<WriteContractParameters<TAbi, typeof functionName, TChain, TAccount>> {\n            if (options.gas) {\n              debug(\"gas provided, skipping simulate\", functionName, options);\n              return options as unknown as WriteContractParameters<TAbi, typeof functionName, TChain, TAccount>;\n            }\n\n            debug(\"simulating write\", functionName, options);\n            const { request } = await publicClient.simulateContract({\n              ...options,\n              account: options.account ?? walletClient.account,\n            } as unknown as SimulateContractParameters<TAbi, typeof functionName, TChain>);\n\n            return request as unknown as WriteContractParameters<TAbi, typeof functionName, TChain, TAccount>;\n          }\n\n          async function write(options: WriteContractParameters): Promise<Hex> {\n            const preparedWrite = await prepareWrite(options);\n\n            return await pRetry(\n              async () => {\n                if (!nonceManager.hasNonce()) {\n                  await nonceManager.resetNonce();\n                }\n\n                const nonce = nonceManager.nextNonce();\n                debug(\"calling write function with nonce\", nonce, preparedWrite);\n                return await walletClient.writeContract({\n                  nonce,\n                  ...preparedWrite,\n                });\n              },\n              {\n                retries: 3,\n                onFailedAttempt: async (error) => {\n                  // On nonce errors, reset the nonce and retry\n                  if (nonceManager.shouldResetNonce(error)) {\n                    debug(\"got nonce error, retrying\", error);\n                    await nonceManager.resetNonce();\n                    return;\n                  }\n                  // TODO: prepareWrite again if there are gas errors?\n                  throw error;\n                },\n              }\n            );\n          }\n\n          return (...parameters) => {\n            const id = `${walletClient.chain.id}:${walletClient.account.address}:${nextWriteId++}`;\n            const { args, options } = <\n              {\n                args: unknown[];\n                options: UnionOmit<WriteContractParameters, \"address\" | \"abi\" | \"functionName\" | \"args\">;\n              }\n            >getFunctionParameters(parameters as any);\n\n            const request = {\n              address,\n              abi,\n              functionName,\n              args,\n              ...options,\n            };\n\n            const result = write(request);\n\n            onWrite?.({ id, request, result });\n\n            return result;\n          };\n        },\n      }\n    );\n  }\n\n  return contract as unknown as GetContractReturnType<TAbi, TPublicClient, TWalletClient, TAddress>;\n}\n","import {\n  BaseError,\n  BlockTag,\n  Hex,\n  NonceTooHighError,\n  NonceTooLowError,\n  PublicClient,\n  TransactionExecutionError,\n} from \"viem\";\nimport { debug as parentDebug } from \"./debug\";\n\nconst debug = parentDebug.extend(\"createNonceManager\");\n\ntype CreateNonceManagerOptions = {\n  publicClient: PublicClient;\n  address: Hex;\n  blockTag?: BlockTag;\n};\n\ntype CreateNonceManagerResult = {\n  hasNonce: () => boolean;\n  nextNonce: () => number;\n  resetNonce: () => Promise<void>;\n  shouldResetNonce: (error: unknown) => boolean;\n};\n\nexport function createNonceManager({\n  publicClient,\n  address,\n  blockTag,\n}: CreateNonceManagerOptions): CreateNonceManagerResult {\n  const nonceRef = { current: -1 };\n  const channel =\n    typeof BroadcastChannel !== \"undefined\"\n      ? // TODO: fetch chain ID or require it via types?\n        new BroadcastChannel(`mud:createNonceManager:${publicClient.chain?.id}:${address}`)\n      : null;\n\n  if (channel) {\n    channel.addEventListener(\"message\", (event) => {\n      const nonce = JSON.parse(event.data);\n      debug(\"got nonce from broadcast channel\", nonce);\n      nonceRef.current = nonce;\n    });\n  }\n\n  function hasNonce(): boolean {\n    return nonceRef.current >= 0;\n  }\n\n  function nextNonce(): number {\n    if (!hasNonce()) throw new Error(\"call resetNonce before using nextNonce\");\n    const nonce = nonceRef.current++;\n    channel?.postMessage(JSON.stringify(nonceRef.current));\n    return nonce;\n  }\n\n  async function resetNonce(): Promise<void> {\n    const nonce = await publicClient.getTransactionCount({ address, blockTag });\n    nonceRef.current = nonce;\n    channel?.postMessage(JSON.stringify(nonceRef.current));\n    debug(\"reset nonce to\", nonceRef.current);\n  }\n\n  function shouldResetNonce(error: unknown): boolean {\n    return (\n      error instanceof BaseError &&\n      error.walk((e) => e instanceof NonceTooLowError || e instanceof NonceTooHighError) != null\n    );\n  }\n\n  return {\n    hasNonce,\n    nextNonce,\n    resetNonce,\n    shouldResetNonce,\n  };\n}\n","import createDebug from \"debug\";\n\nexport const debug = createDebug(\"mud:common\");\n","import { generatePrivateKey, privateKeyToAccount } from \"viem/accounts\";\nimport { isHex, Hex } from \"viem\";\n\nfunction assertPrivateKey(privateKey: string, cacheKey: string): asserts privateKey is Hex {\n  if (!isHex(privateKey)) {\n    console.error(\"Private key found in cache is not valid hex\", { privateKey, cacheKey });\n    throw new Error(`Private key found in cache (${cacheKey}) is not valid hex`);\n  }\n  // ensure we can extract address from private key\n  // this should throw on bad private keys\n  privateKeyToAccount(privateKey);\n}\n\nexport function getBurnerPrivateKey(cacheKey = \"mud:burnerWallet\"): Hex {\n  const cachedPrivateKey = localStorage.getItem(cacheKey);\n\n  if (cachedPrivateKey != null) {\n    assertPrivateKey(cachedPrivateKey, cacheKey);\n    return cachedPrivateKey;\n  }\n\n  const privateKey = generatePrivateKey();\n  console.log(\"New burner wallet created:\", privateKeyToAccount(privateKey));\n  localStorage.setItem(cacheKey, privateKey);\n  return privateKey;\n}\n","import { Hex, hexToString, sliceHex } from \"viem\";\nimport { ResourceId } from \"./common\";\nimport { ResourceType, resourceTypes } from \"./resourceTypes\";\nimport { resourceTypeIds } from \"./resourceIdToHex\";\nimport { ReverseMap } from \"./type-utils/common\";\n\nconst resourceTypeIdToType = Object.fromEntries(\n  Object.entries(resourceTypeIds).map(([key, value]) => [value, key])\n) as ReverseMap<typeof resourceTypeIds>;\n\nfunction getResourceType(resourceTypeId: string): ResourceType | undefined {\n  // TODO: replace Partial with `noUncheckedIndexedAccess`\n  const type = (resourceTypeIdToType as Partial<Record<string, ResourceType>>)[resourceTypeId];\n  if (resourceTypes.includes(type as ResourceType)) {\n    return type;\n  }\n}\n\nexport function hexToResourceId(hex: Hex): ResourceId {\n  const resourceTypeId = hexToString(sliceHex(hex, 0, 2)).replace(/\\0+$/, \"\");\n  const type = getResourceType(resourceTypeId);\n  const namespace = hexToString(sliceHex(hex, 2, 16)).replace(/\\0+$/, \"\");\n  const name = hexToString(sliceHex(hex, 16, 32)).replace(/\\0+$/, \"\");\n\n  if (!type) {\n    throw new Error(`Unknown resource type: ${resourceTypeId}`);\n  }\n\n  return { type, namespace, name };\n}\n","export const resourceTypes = [\"table\", \"offchainTable\", \"namespace\", \"module\", \"system\"] as const;\n\nexport type ResourceType = (typeof resourceTypes)[number];\n","import { Hex, stringToHex, concatHex } from \"viem\";\nimport { ResourceId } from \"./common\";\nimport { ResourceType } from \"./resourceTypes\";\n\n/** @internal */\nexport const resourceTypeIds = {\n  // keep these in sync with storeResourceTypes.sol\n  table: \"tb\",\n  offchainTable: \"ot\",\n  // keep these in sync with worldResourceTypes.sol\n  namespace: \"ns\",\n  module: \"md\",\n  system: \"sy\",\n} as const satisfies Record<ResourceType, string>;\n\nexport function resourceIdToHex(resourceId: ResourceId): Hex {\n  const typeId = resourceTypeIds[resourceId.type];\n  return concatHex([\n    stringToHex(typeId, { size: 2 }),\n    stringToHex(resourceId.namespace.slice(0, 14), { size: 14 }),\n    stringToHex(resourceId.name.slice(0, 16), { size: 16 }),\n  ]);\n}\n","import { Hex } from \"viem\";\n\n/**\n * Get the hex value at start/end positions. This will always return a valid hex string.\n *\n * If `start` is out of range, this returns `\"0x\"`.\n *\n * If `end` is specified and out of range, the result is right zero-padded to the desired length (`end - start`).\n */\nexport function readHex(data: Hex, start: number, end?: number): Hex {\n  return `0x${data\n    .replace(/^0x/, \"\")\n    .slice(start * 2, end != null ? end * 2 : undefined)\n    .padEnd(((end ?? start) - start) * 2, \"0\")}`;\n}\n","import { Hex, concatHex } from \"viem\";\nimport { readHex } from \"./readHex\";\n\nexport function spliceHex(data: Hex, start: number, deleteCount = 0, newData: Hex = \"0x\"): Hex {\n  return concatHex([readHex(data, 0, start), newData, readHex(data, start + deleteCount)]);\n}\n","import { Hex, Transport, keccak256 } from \"viem\";\nimport { debug as parentDebug } from \"./debug\";\n\nconst debug = parentDebug.extend(\"transportObserver\");\n\nexport function transportObserver<TTransport extends Transport>(transport: TTransport): TTransport {\n  return ((opts) => {\n    const result = transport(opts);\n    const request: typeof result.request = async (req) => {\n      if (req.method === \"eth_sendRawTransaction\" && req.params instanceof Array) {\n        const txs = req.params.map((data: Hex) => keccak256(data));\n        debug(\"saw txs\", txs);\n        // TODO: pass these tx hashes into dev tools\n      }\n      // TODO: add support for `eth_sendTransaction`\n      return result.request(req);\n    };\n    return {\n      ...result,\n      request,\n    };\n  }) as TTransport;\n}\n"],"mappings":"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","names":["privateKeyToAccount","createBurnerAccount","privateKey","getContract","pRetry","BaseError","NonceTooHighError","NonceTooLowError","createDebug","debug","debug","createNonceManager","publicClient","address","blockTag","nonceRef","channel","event","nonce","hasNonce","nextNonce","resetNonce","shouldResetNonce","error","BaseError","e","NonceTooLowError","NonceTooHighError","debug","getFunctionParameters","values","hasArgs","args","options","createContract","abi","address","publicClient","walletClient","onWrite","contract","getContract","nextWriteId","nonceManager","createNonceManager","_","functionName","prepareWrite","request","write","preparedWrite","pRetry","nonce","error","parameters","id","result","generatePrivateKey","privateKeyToAccount","isHex","assertPrivateKey","privateKey","cacheKey","getBurnerPrivateKey","cachedPrivateKey","hexToString","sliceHex","resourceTypes","stringToHex","concatHex","resourceTypeIds","resourceIdToHex","resourceId","typeId","resourceTypeIdToType","resourceTypeIds","key","value","getResourceType","resourceTypeId","type","resourceTypes","hexToResourceId","hex","hexToString","sliceHex","namespace","name","readHex","data","start","end","concatHex","spliceHex","data","start","deleteCount","newData","concatHex","readHex","keccak256","debug","transportObserver","transport","opts","result","req","txs","data","keccak256"]}
+{"version":3,"sources":["../src/createBurnerAccount.ts","../src/createNonceManager.ts","../src/debug.ts","../src/getNonceManagerId.ts","../src/getContract.ts","../src/writeContract.ts","../src/getNonceManager.ts","../src/getBurnerPrivateKey.ts","../src/hexToResourceId.ts","../src/resourceTypes.ts","../src/resourceIdToHex.ts","../src/readHex.ts","../src/spliceHex.ts","../src/transportObserver.ts","../src/createContract.ts"],"sourcesContent":["import { Account, Hex } from \"viem\";\nimport { privateKeyToAccount } from \"viem/accounts\";\n\nexport function createBurnerAccount(privateKey: Hex): Account {\n  const account = privateKeyToAccount(privateKey);\n  // We may override account features here\n  return {\n    ...account,\n  };\n}\n","import { BaseError, BlockTag, Client, Hex, NonceTooHighError, NonceTooLowError } from \"viem\";\nimport { debug as parentDebug } from \"./debug\";\nimport { getNonceManagerId } from \"./getNonceManagerId\";\nimport { getTransactionCount } from \"viem/actions\";\n\nconst debug = parentDebug.extend(\"createNonceManager\");\n\nexport type CreateNonceManagerOptions = {\n  client: Client;\n  address: Hex;\n  blockTag?: BlockTag;\n  broadcastChannelName?: string;\n};\n\nexport type CreateNonceManagerResult = {\n  hasNonce: () => boolean;\n  nextNonce: () => number;\n  resetNonce: () => Promise<void>;\n  shouldResetNonce: (error: unknown) => boolean;\n};\n\nexport function createNonceManager({\n  client,\n  address,\n  blockTag = \"latest\",\n  broadcastChannelName,\n}: CreateNonceManagerOptions): CreateNonceManagerResult {\n  const nonceRef = { current: -1 };\n  let channel: BroadcastChannel | null = null;\n\n  if (typeof BroadcastChannel !== \"undefined\") {\n    const channelName = broadcastChannelName\n      ? Promise.resolve(broadcastChannelName)\n      : getNonceManagerId({ client, address, blockTag });\n    channelName.then((name) => {\n      channel = new BroadcastChannel(name);\n      // TODO: emit some sort of \"connected\" event so other channels can broadcast current nonce\n      channel.addEventListener(\"message\", (event) => {\n        const nonce = JSON.parse(event.data);\n        debug(\"got nonce from broadcast channel\", nonce);\n        nonceRef.current = nonce;\n      });\n    });\n  }\n\n  function hasNonce(): boolean {\n    return nonceRef.current >= 0;\n  }\n\n  function nextNonce(): number {\n    if (!hasNonce()) throw new Error(\"call resetNonce before using nextNonce\");\n    const nonce = nonceRef.current++;\n    channel?.postMessage(JSON.stringify(nonceRef.current));\n    return nonce;\n  }\n\n  async function resetNonce(): Promise<void> {\n    const nonce = await getTransactionCount(client, { address, blockTag });\n    nonceRef.current = nonce;\n    channel?.postMessage(JSON.stringify(nonceRef.current));\n    debug(\"reset nonce to\", nonceRef.current);\n  }\n\n  function shouldResetNonce(error: unknown): boolean {\n    return (\n      error instanceof BaseError &&\n      error.walk((e) => e instanceof NonceTooLowError || e instanceof NonceTooHighError) != null\n    );\n  }\n\n  return {\n    hasNonce,\n    nextNonce,\n    resetNonce,\n    shouldResetNonce,\n  };\n}\n","import createDebug from \"debug\";\n\nexport const debug = createDebug(\"mud:common\");\n","import { BlockTag, Client, Hex, getAddress } from \"viem\";\nimport { getChainId } from \"viem/actions\";\n\nexport async function getNonceManagerId({\n  client,\n  address,\n  blockTag,\n}: {\n  client: Client;\n  address: Hex;\n  blockTag: BlockTag;\n}): Promise<string> {\n  const chainId = client.chain?.id ?? (await getChainId(client));\n  return `mud:createNonceManager:${chainId}:${getAddress(address)}:${blockTag}`;\n}\n","import {\n  Abi,\n  Account,\n  Address,\n  Chain,\n  GetContractParameters,\n  GetContractReturnType,\n  PublicClient,\n  Transport,\n  WalletClient,\n  WriteContractParameters,\n  getContract as viem_getContract,\n} from \"viem\";\nimport { UnionOmit } from \"./type-utils/common\";\nimport { WriteContractOptions, writeContract } from \"./writeContract\";\n\n// copied from viem because this isn't exported\n// TODO: import from viem?\nfunction getFunctionParameters(values: [args?: readonly unknown[], options?: object]): {\n  args: readonly unknown[];\n  options: object;\n} {\n  const hasArgs = values.length && Array.isArray(values[0]);\n  const args = hasArgs ? values[0]! : [];\n  const options = (hasArgs ? values[1] : values[0]) ?? {};\n  return { args, options };\n}\n\nexport type GetContractOptions<\n  TTransport extends Transport,\n  TAddress extends Address,\n  TAbi extends Abi,\n  TChain extends Chain,\n  TAccount extends Account,\n  TPublicClient extends PublicClient<TTransport, TChain>,\n  TWalletClient extends WalletClient<TTransport, TChain, TAccount>\n> = Required<GetContractParameters<TTransport, TChain, TAccount, TAbi, TPublicClient, TWalletClient, TAddress>> & {\n  onWrite?: WriteContractOptions[\"onWrite\"];\n};\n\n// TODO: migrate away from this approach once we can hook into viem: https://github.com/wagmi-dev/viem/discussions/1230\n\nexport function getContract<\n  TTransport extends Transport,\n  TAddress extends Address,\n  TAbi extends Abi,\n  TChain extends Chain,\n  TAccount extends Account,\n  TPublicClient extends PublicClient<TTransport, TChain>,\n  TWalletClient extends WalletClient<TTransport, TChain, TAccount>\n>({\n  abi,\n  address,\n  publicClient,\n  walletClient,\n  onWrite,\n}: GetContractOptions<\n  TTransport,\n  TAddress,\n  TAbi,\n  TChain,\n  TAccount,\n  TPublicClient,\n  TWalletClient\n>): GetContractReturnType<TAbi, TPublicClient, TWalletClient, TAddress> {\n  const contract = viem_getContract<TTransport, TAddress, TAbi, TChain, TAccount, TPublicClient, TWalletClient>({\n    abi,\n    address,\n    publicClient,\n    walletClient,\n  }) as unknown as GetContractReturnType<Abi, PublicClient, WalletClient>;\n\n  if (contract.write) {\n    // Replace write calls with our own. Implemented ~the same as viem, but adds better handling of nonces (via queue + retries).\n    contract.write = new Proxy(\n      {},\n      {\n        get(_, functionName: string) {\n          return (\n            ...parameters: [\n              args?: readonly unknown[],\n              options?: UnionOmit<WriteContractParameters, \"abi\" | \"address\" | \"functionName\" | \"args\">\n            ]\n          ) => {\n            const { args, options } = getFunctionParameters(parameters);\n            return writeContract(walletClient, {\n              abi,\n              address,\n              functionName,\n              args,\n              ...options,\n              onWrite,\n            } as unknown as WriteContractOptions<TAbi, typeof functionName, TChain, TAccount>);\n          };\n        },\n      }\n    );\n  }\n\n  return contract as unknown as GetContractReturnType<TAbi, TPublicClient, TWalletClient, TAddress>;\n}\n","import {\n  Abi,\n  Account,\n  Chain,\n  Client,\n  Hex,\n  SimulateContractParameters,\n  Transport,\n  WriteContractParameters,\n  WriteContractReturnType,\n} from \"viem\";\nimport { simulateContract, writeContract as viem_writeContract } from \"viem/actions\";\nimport pRetry from \"p-retry\";\nimport { debug as parentDebug } from \"./debug\";\nimport { getNonceManager } from \"./getNonceManager\";\nimport { parseAccount } from \"viem/accounts\";\n\nconst debug = parentDebug.extend(\"writeContract\");\nlet nextWriteId = 0;\n\nexport type ContractWrite<\n  TAbi extends Abi | readonly unknown[] = Abi,\n  TFunctionName extends string = string,\n  TChain extends Chain | undefined = Chain,\n  TAccount extends Account | undefined = Account | undefined,\n  TChainOverride extends Chain | undefined = Chain | undefined\n> = {\n  id: string;\n  request: WriteContractParameters<TAbi, TFunctionName, TChain, TAccount, TChainOverride>;\n  result: Promise<Hex>;\n};\n\nexport type WriteContractOptions<\n  TAbi extends Abi | readonly unknown[] = Abi,\n  TFunctionName extends string = string,\n  TChain extends Chain | undefined = Chain,\n  TAccount extends Account | undefined = Account | undefined,\n  TChainOverride extends Chain | undefined = Chain | undefined\n> = WriteContractParameters<TAbi, TFunctionName, TChain, TAccount, TChainOverride> & {\n  onWrite?: (write: ContractWrite<TAbi, TFunctionName, TChain, TAccount, TChainOverride>) => void;\n};\n\n// TODO: migrate away from this approach once we can hook into viem's nonce management: https://github.com/wagmi-dev/viem/discussions/1230\n\nexport async function writeContract<\n  TChain extends Chain | undefined,\n  TAccount extends Account | undefined,\n  TAbi extends Abi | readonly unknown[],\n  TFunctionName extends string,\n  TChainOverride extends Chain | undefined\n>(\n  client: Client<Transport, TChain, TAccount>,\n  { onWrite, ...request_ }: WriteContractOptions<TAbi, TFunctionName, TChain, TAccount, TChainOverride>\n): Promise<WriteContractReturnType> {\n  const request = request_ as WriteContractParameters<TAbi, TFunctionName, TChain, TAccount, TChainOverride>;\n\n  const account_ = request.account ?? client.account;\n  if (!account_) {\n    // TODO: replace with viem AccountNotFoundError once its exported\n    throw new Error(\"No account provided\");\n  }\n  const account = parseAccount(account_);\n\n  const nonceManager = await getNonceManager({\n    client,\n    address: account.address,\n  });\n\n  async function prepareWrite(): Promise<\n    WriteContractParameters<TAbi, TFunctionName, TChain, TAccount, TChainOverride>\n  > {\n    if (request.gas) {\n      debug(\"gas provided, skipping simulate\", request);\n      return request;\n    }\n\n    debug(\"simulating write\", request);\n    const result = await simulateContract<TChain, TAbi, TFunctionName, TChainOverride>(client, {\n      ...request,\n      account,\n    } as unknown as SimulateContractParameters<TAbi, TFunctionName, TChain, TChainOverride>);\n\n    return result.request as unknown as WriteContractParameters<TAbi, TFunctionName, TChain, TAccount, TChainOverride>;\n  }\n\n  async function write(): Promise<Hex> {\n    const preparedWrite = await prepareWrite();\n\n    return await pRetry(\n      async () => {\n        if (!nonceManager.hasNonce()) {\n          await nonceManager.resetNonce();\n        }\n\n        const nonce = nonceManager.nextNonce();\n        debug(\"calling write function with nonce\", nonce, preparedWrite);\n        return await viem_writeContract(client, { nonce, ...preparedWrite } as typeof preparedWrite);\n      },\n      {\n        retries: 3,\n        onFailedAttempt: async (error) => {\n          // On nonce errors, reset the nonce and retry\n          if (nonceManager.shouldResetNonce(error)) {\n            debug(\"got nonce error, retrying\", error);\n            await nonceManager.resetNonce();\n            return;\n          }\n          // TODO: prepareWrite again if there are gas errors?\n          throw error;\n        },\n      }\n    );\n  }\n\n  const result = write();\n\n  onWrite?.({ id: `${nextWriteId++}`, request, result });\n\n  return result;\n}\n","import { CreateNonceManagerOptions, CreateNonceManagerResult, createNonceManager } from \"./createNonceManager\";\nimport { getNonceManagerId } from \"./getNonceManagerId\";\n\nconst nonceManagers = new Map<string, CreateNonceManagerResult>();\n\nexport async function getNonceManager({\n  client,\n  address,\n  blockTag = \"latest\",\n}: CreateNonceManagerOptions): Promise<CreateNonceManagerResult> {\n  const id = await getNonceManagerId({ client, address, blockTag });\n\n  const existingNonceManager = nonceManagers.get(id);\n  if (existingNonceManager) {\n    return existingNonceManager;\n  }\n\n  const nonceManager = createNonceManager({ client, address, blockTag });\n  nonceManagers.set(id, nonceManager);\n  return nonceManager;\n}\n","import { generatePrivateKey, privateKeyToAccount } from \"viem/accounts\";\nimport { isHex, Hex } from \"viem\";\n\nfunction assertPrivateKey(privateKey: string, cacheKey: string): asserts privateKey is Hex {\n  if (!isHex(privateKey)) {\n    console.error(\"Private key found in cache is not valid hex\", { privateKey, cacheKey });\n    throw new Error(`Private key found in cache (${cacheKey}) is not valid hex`);\n  }\n  // ensure we can extract address from private key\n  // this should throw on bad private keys\n  privateKeyToAccount(privateKey);\n}\n\nexport function getBurnerPrivateKey(cacheKey = \"mud:burnerWallet\"): Hex {\n  const cachedPrivateKey = localStorage.getItem(cacheKey);\n\n  if (cachedPrivateKey != null) {\n    assertPrivateKey(cachedPrivateKey, cacheKey);\n    return cachedPrivateKey;\n  }\n\n  const privateKey = generatePrivateKey();\n  console.log(\"New burner wallet created:\", privateKeyToAccount(privateKey));\n  localStorage.setItem(cacheKey, privateKey);\n  return privateKey;\n}\n","import { Hex, hexToString, sliceHex } from \"viem\";\nimport { ResourceId } from \"./common\";\nimport { ResourceType, resourceTypes } from \"./resourceTypes\";\nimport { resourceTypeIds } from \"./resourceIdToHex\";\nimport { ReverseMap } from \"./type-utils/common\";\n\nconst resourceTypeIdToType = Object.fromEntries(\n  Object.entries(resourceTypeIds).map(([key, value]) => [value, key])\n) as ReverseMap<typeof resourceTypeIds>;\n\nfunction getResourceType(resourceTypeId: string): ResourceType | undefined {\n  // TODO: replace Partial with `noUncheckedIndexedAccess`\n  const type = (resourceTypeIdToType as Partial<Record<string, ResourceType>>)[resourceTypeId];\n  if (resourceTypes.includes(type as ResourceType)) {\n    return type;\n  }\n}\n\nexport function hexToResourceId(hex: Hex): ResourceId {\n  const resourceTypeId = hexToString(sliceHex(hex, 0, 2)).replace(/\\0+$/, \"\");\n  const type = getResourceType(resourceTypeId);\n  const namespace = hexToString(sliceHex(hex, 2, 16)).replace(/\\0+$/, \"\");\n  const name = hexToString(sliceHex(hex, 16, 32)).replace(/\\0+$/, \"\");\n\n  if (!type) {\n    throw new Error(`Unknown resource type: ${resourceTypeId}`);\n  }\n\n  return { type, namespace, name };\n}\n","export const resourceTypes = [\"table\", \"offchainTable\", \"namespace\", \"module\", \"system\"] as const;\n\nexport type ResourceType = (typeof resourceTypes)[number];\n","import { Hex, stringToHex, concatHex } from \"viem\";\nimport { ResourceId } from \"./common\";\nimport { ResourceType } from \"./resourceTypes\";\n\n/** @internal */\nexport const resourceTypeIds = {\n  // keep these in sync with storeResourceTypes.sol\n  table: \"tb\",\n  offchainTable: \"ot\",\n  // keep these in sync with worldResourceTypes.sol\n  namespace: \"ns\",\n  module: \"md\",\n  system: \"sy\",\n} as const satisfies Record<ResourceType, string>;\n\nexport function resourceIdToHex(resourceId: ResourceId): Hex {\n  const typeId = resourceTypeIds[resourceId.type];\n  return concatHex([\n    stringToHex(typeId, { size: 2 }),\n    stringToHex(resourceId.namespace.slice(0, 14), { size: 14 }),\n    stringToHex(resourceId.name.slice(0, 16), { size: 16 }),\n  ]);\n}\n","import { Hex } from \"viem\";\n\n/**\n * Get the hex value at start/end positions. This will always return a valid hex string.\n *\n * If `start` is out of range, this returns `\"0x\"`.\n *\n * If `end` is specified and out of range, the result is right zero-padded to the desired length (`end - start`).\n */\nexport function readHex(data: Hex, start: number, end?: number): Hex {\n  return `0x${data\n    .replace(/^0x/, \"\")\n    .slice(start * 2, end != null ? end * 2 : undefined)\n    .padEnd(((end ?? start) - start) * 2, \"0\")}`;\n}\n","import { Hex, concatHex } from \"viem\";\nimport { readHex } from \"./readHex\";\n\nexport function spliceHex(data: Hex, start: number, deleteCount = 0, newData: Hex = \"0x\"): Hex {\n  return concatHex([readHex(data, 0, start), newData, readHex(data, start + deleteCount)]);\n}\n","import { Hex, Transport, keccak256 } from \"viem\";\nimport { debug as parentDebug } from \"./debug\";\n\nconst debug = parentDebug.extend(\"transportObserver\");\n\nexport function transportObserver<TTransport extends Transport>(transport: TTransport): TTransport {\n  return ((opts) => {\n    const result = transport(opts);\n    const request: typeof result.request = async (req) => {\n      if (req.method === \"eth_sendRawTransaction\" && req.params instanceof Array) {\n        const txs = req.params.map((data: Hex) => keccak256(data));\n        debug(\"saw txs\", txs);\n        // TODO: pass these tx hashes into dev tools\n      }\n      // TODO: add support for `eth_sendTransaction`\n      return result.request(req);\n    };\n    return {\n      ...result,\n      request,\n    };\n  }) as TTransport;\n}\n","import { getContract } from \"./getContract\";\n\n/** @deprecated use `getContract` instead */\nexport const createContract = getContract;\n"],"mappings":"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","names":["privateKeyToAccount","createBurnerAccount","privateKey","BaseError","NonceTooHighError","NonceTooLowError","createDebug","debug","getAddress","getChainId","getNonceManagerId","client","address","blockTag","getTransactionCount","debug","createNonceManager","client","address","blockTag","broadcastChannelName","nonceRef","channel","getNonceManagerId","name","event","nonce","hasNonce","nextNonce","resetNonce","shouldResetNonce","error","BaseError","e","NonceTooLowError","NonceTooHighError","viem_getContract","simulateContract","viem_writeContract","pRetry","nonceManagers","getNonceManager","client","address","blockTag","id","getNonceManagerId","existingNonceManager","nonceManager","createNonceManager","parseAccount","debug","nextWriteId","writeContract","client","onWrite","request_","request","account_","account","nonceManager","getNonceManager","prepareWrite","simulateContract","write","preparedWrite","pRetry","nonce","viem_writeContract","error","result","getFunctionParameters","values","hasArgs","args","options","getContract","abi","address","publicClient","walletClient","onWrite","contract","viem_getContract","_","functionName","parameters","writeContract","generatePrivateKey","privateKeyToAccount","isHex","assertPrivateKey","privateKey","cacheKey","getBurnerPrivateKey","cachedPrivateKey","hexToString","sliceHex","resourceTypes","stringToHex","concatHex","resourceTypeIds","resourceIdToHex","resourceId","typeId","resourceTypeIdToType","resourceTypeIds","key","value","getResourceType","resourceTypeId","type","resourceTypes","hexToResourceId","hex","hexToString","sliceHex","namespace","name","readHex","data","start","end","concatHex","spliceHex","data","start","deleteCount","newData","concatHex","readHex","keccak256","debug","transportObserver","transport","opts","result","req","txs","data","keccak256","createContract","getContract"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@latticexyz/common",
-  "version": "2.0.0-next.10",
+  "version": "2.0.0-next.11",
   "description": "Common low level logic shared between packages",
   "repository": {
     "type": "git",
@@ -49,15 +49,14 @@
   },
   "dependencies": {
     "@solidity-parser/parser": "^0.16.0",
-    "abitype": "0.9.3",
     "chalk": "^5.2.0",
     "debug": "^4.3.4",
     "execa": "^7.0.0",
     "p-retry": "^5.1.2",
     "prettier": "^2.8.4",
     "prettier-plugin-solidity": "^1.1.2",
-    "viem": "1.6.0",
-    "@latticexyz/schema-type": "2.0.0-next.10"
+    "viem": "1.14.0",
+    "@latticexyz/schema-type": "2.0.0-next.11"
   },
   "devDependencies": {
     "@types/debug": "^4.1.7",

package/src/chains/latticeTestnet.ts

@@ -16,10 +16,6 @@ export const latticeTestnet = {
     },
   },
   blockExplorers: {
-    otterscan: {
-      name: "Otterscan",
-      url: "https://explorer.testnet-chain.linfra.xyz",
-    },
     default: {
       name: "Otterscan",
       url: "https://explorer.testnet-chain.linfra.xyz",

package/src/chains/mudFoundry.ts

@@ -4,6 +4,7 @@ import { MUDChain } from "./types";
 export const mudFoundry = {
   ...foundry,
   fees: {
-    defaultPriorityFee: 0n,
+    // This is intentionally defined as a function as a workaround for https://github.com/wagmi-dev/viem/pull/1280
+    defaultPriorityFee: () => 0n,
   },
 } as const satisfies MUDChain;

package/src/createContract.ts

@@ -1,173 +1,4 @@
-import {
-  Abi,
-  Account,
-  Address,
-  Chain,
-  GetContractParameters,
-  GetContractReturnType,
-  Hex,
-  PublicClient,
-  SimulateContractParameters,
-  Transport,
-  WalletClient,
-  WriteContractParameters,
-  getContract,
-} from "viem";
-import pRetry from "p-retry";
-import { createNonceManager } from "./createNonceManager";
-import { debug as parentDebug } from "./debug";
-import { UnionOmit } from "./type-utils/common";
+import { getContract } from "./getContract";
 
-const debug = parentDebug.extend("createContract");
-
-// copied from viem because this isn't exported
-// TODO: import from viem?
-function getFunctionParameters(values: [args?: readonly unknown[], options?: object]): {
-  args: readonly unknown[];
-  options: object;
-} {
-  const hasArgs = values.length && Array.isArray(values[0]);
-  const args = hasArgs ? values[0]! : [];
-  const options = (hasArgs ? values[1] : values[0]) ?? {};
-  return { args, options };
-}
-
-export type ContractWrite = {
-  id: string;
-  request: WriteContractParameters;
-  result: Promise<Hex>;
-};
-
-export type CreateContractOptions<
-  TTransport extends Transport,
-  TAddress extends Address,
-  TAbi extends Abi,
-  TChain extends Chain,
-  TAccount extends Account,
-  TPublicClient extends PublicClient<TTransport, TChain>,
-  TWalletClient extends WalletClient<TTransport, TChain, TAccount>
-> = Required<GetContractParameters<TTransport, TChain, TAccount, TAbi, TPublicClient, TWalletClient, TAddress>> & {
-  onWrite?: (write: ContractWrite) => void;
-};
-
-export function createContract<
-  TTransport extends Transport,
-  TAddress extends Address,
-  TAbi extends Abi,
-  TChain extends Chain,
-  TAccount extends Account,
-  TPublicClient extends PublicClient<TTransport, TChain>,
-  TWalletClient extends WalletClient<TTransport, TChain, TAccount>
->({
-  abi,
-  address,
-  publicClient,
-  walletClient,
-  onWrite,
-}: CreateContractOptions<
-  TTransport,
-  TAddress,
-  TAbi,
-  TChain,
-  TAccount,
-  TPublicClient,
-  TWalletClient
->): GetContractReturnType<TAbi, TPublicClient, TWalletClient, TAddress> {
-  const contract = getContract<TTransport, TAddress, TAbi, TChain, TAccount, TPublicClient, TWalletClient>({
-    abi,
-    address,
-    publicClient,
-    walletClient,
-  }) as unknown as GetContractReturnType<Abi, PublicClient, WalletClient>;
-
-  if (contract.write) {
-    let nextWriteId = 0;
-    const nonceManager = createNonceManager({
-      publicClient: publicClient as PublicClient,
-      address: walletClient.account.address,
-    });
-
-    // Replace write calls with our own proxy. Implemented ~the same as viem, but adds better handling of nonces (via queue + retries).
-    contract.write = new Proxy(
-      {},
-      {
-        get(_, functionName: string): GetContractReturnType<Abi, PublicClient, WalletClient>["write"][string] {
-          async function prepareWrite(
-            options: WriteContractParameters
-          ): Promise<WriteContractParameters<TAbi, typeof functionName, TChain, TAccount>> {
-            if (options.gas) {
-              debug("gas provided, skipping simulate", functionName, options);
-              return options as unknown as WriteContractParameters<TAbi, typeof functionName, TChain, TAccount>;
-            }
-
-            debug("simulating write", functionName, options);
-            const { request } = await publicClient.simulateContract({
-              ...options,
-              account: options.account ?? walletClient.account,
-            } as unknown as SimulateContractParameters<TAbi, typeof functionName, TChain>);
-
-            return request as unknown as WriteContractParameters<TAbi, typeof functionName, TChain, TAccount>;
-          }
-
-          async function write(options: WriteContractParameters): Promise<Hex> {
-            const preparedWrite = await prepareWrite(options);
-
-            return await pRetry(
-              async () => {
-                if (!nonceManager.hasNonce()) {
-                  await nonceManager.resetNonce();
-                }
-
-                const nonce = nonceManager.nextNonce();
-                debug("calling write function with nonce", nonce, preparedWrite);
-                return await walletClient.writeContract({
-                  nonce,
-                  ...preparedWrite,
-                });
-              },
-              {
-                retries: 3,
-                onFailedAttempt: async (error) => {
-                  // On nonce errors, reset the nonce and retry
-                  if (nonceManager.shouldResetNonce(error)) {
-                    debug("got nonce error, retrying", error);
-                    await nonceManager.resetNonce();
-                    return;
-                  }
-                  // TODO: prepareWrite again if there are gas errors?
-                  throw error;
-                },
-              }
-            );
-          }
-
-          return (...parameters) => {
-            const id = `${walletClient.chain.id}:${walletClient.account.address}:${nextWriteId++}`;
-            const { args, options } = <
-              {
-                args: unknown[];
-                options: UnionOmit<WriteContractParameters, "address" | "abi" | "functionName" | "args">;
-              }
-            >getFunctionParameters(parameters as any);
-
-            const request = {
-              address,
-              abi,
-              functionName,
-              args,
-              ...options,
-            };
-
-            const result = write(request);
-
-            onWrite?.({ id, request, result });
-
-            return result;
-          };
-        },
-      }
-    );
-  }
-
-  return contract as unknown as GetContractReturnType<TAbi, TPublicClient, TWalletClient, TAddress>;
-}
+/** @deprecated use `getContract` instead */
+export const createContract = getContract;

package/src/createNonceManager.ts

@@ -1,23 +1,18 @@
-import {
-  BaseError,
-  BlockTag,
-  Hex,
-  NonceTooHighError,
-  NonceTooLowError,
-  PublicClient,
-  TransactionExecutionError,
-} from "viem";
+import { BaseError, BlockTag, Client, Hex, NonceTooHighError, NonceTooLowError } from "viem";
 import { debug as parentDebug } from "./debug";
+import { getNonceManagerId } from "./getNonceManagerId";
+import { getTransactionCount } from "viem/actions";
 
 const debug = parentDebug.extend("createNonceManager");
 
-type CreateNonceManagerOptions = {
-  publicClient: PublicClient;
+export type CreateNonceManagerOptions = {
+  client: Client;
   address: Hex;
   blockTag?: BlockTag;
+  broadcastChannelName?: string;
 };
 
-type CreateNonceManagerResult = {
+export type CreateNonceManagerResult = {
   hasNonce: () => boolean;
   nextNonce: () => number;
   resetNonce: () => Promise<void>;
@@ -25,22 +20,26 @@ type CreateNonceManagerResult = {
 };
 
 export function createNonceManager({
-  publicClient,
+  client,
   address,
-  blockTag,
+  blockTag = "latest",
+  broadcastChannelName,
 }: CreateNonceManagerOptions): CreateNonceManagerResult {
   const nonceRef = { current: -1 };
-  const channel =
-    typeof BroadcastChannel !== "undefined"
-      ? // TODO: fetch chain ID or require it via types?
-        new BroadcastChannel(`mud:createNonceManager:${publicClient.chain?.id}:${address}`)
-      : null;
+  let channel: BroadcastChannel | null = null;
 
-  if (channel) {
-    channel.addEventListener("message", (event) => {
-      const nonce = JSON.parse(event.data);
-      debug("got nonce from broadcast channel", nonce);
-      nonceRef.current = nonce;
+  if (typeof BroadcastChannel !== "undefined") {
+    const channelName = broadcastChannelName
+      ? Promise.resolve(broadcastChannelName)
+      : getNonceManagerId({ client, address, blockTag });
+    channelName.then((name) => {
+      channel = new BroadcastChannel(name);
+      // TODO: emit some sort of "connected" event so other channels can broadcast current nonce
+      channel.addEventListener("message", (event) => {
+        const nonce = JSON.parse(event.data);
+        debug("got nonce from broadcast channel", nonce);
+        nonceRef.current = nonce;
+      });
     });
   }
 
@@ -56,7 +55,7 @@ export function createNonceManager({
   }
 
   async function resetNonce(): Promise<void> {
-    const nonce = await publicClient.getTransactionCount({ address, blockTag });
+    const nonce = await getTransactionCount(client, { address, blockTag });
     nonceRef.current = nonce;
     channel?.postMessage(JSON.stringify(nonceRef.current));
     debug("reset nonce to", nonceRef.current);

package/src/getContract.ts

@@ -0,0 +1,101 @@
+import {
+  Abi,
+  Account,
+  Address,
+  Chain,
+  GetContractParameters,
+  GetContractReturnType,
+  PublicClient,
+  Transport,
+  WalletClient,
+  WriteContractParameters,
+  getContract as viem_getContract,
+} from "viem";
+import { UnionOmit } from "./type-utils/common";
+import { WriteContractOptions, writeContract } from "./writeContract";
+
+// copied from viem because this isn't exported
+// TODO: import from viem?
+function getFunctionParameters(values: [args?: readonly unknown[], options?: object]): {
+  args: readonly unknown[];
+  options: object;
+} {
+  const hasArgs = values.length && Array.isArray(values[0]);
+  const args = hasArgs ? values[0]! : [];
+  const options = (hasArgs ? values[1] : values[0]) ?? {};
+  return { args, options };
+}
+
+export type GetContractOptions<
+  TTransport extends Transport,
+  TAddress extends Address,
+  TAbi extends Abi,
+  TChain extends Chain,
+  TAccount extends Account,
+  TPublicClient extends PublicClient<TTransport, TChain>,
+  TWalletClient extends WalletClient<TTransport, TChain, TAccount>
+> = Required<GetContractParameters<TTransport, TChain, TAccount, TAbi, TPublicClient, TWalletClient, TAddress>> & {
+  onWrite?: WriteContractOptions["onWrite"];
+};
+
+// TODO: migrate away from this approach once we can hook into viem: https://github.com/wagmi-dev/viem/discussions/1230
+
+export function getContract<
+  TTransport extends Transport,
+  TAddress extends Address,
+  TAbi extends Abi,
+  TChain extends Chain,
+  TAccount extends Account,
+  TPublicClient extends PublicClient<TTransport, TChain>,
+  TWalletClient extends WalletClient<TTransport, TChain, TAccount>
+>({
+  abi,
+  address,
+  publicClient,
+  walletClient,
+  onWrite,
+}: GetContractOptions<
+  TTransport,
+  TAddress,
+  TAbi,
+  TChain,
+  TAccount,
+  TPublicClient,
+  TWalletClient
+>): GetContractReturnType<TAbi, TPublicClient, TWalletClient, TAddress> {
+  const contract = viem_getContract<TTransport, TAddress, TAbi, TChain, TAccount, TPublicClient, TWalletClient>({
+    abi,
+    address,
+    publicClient,
+    walletClient,
+  }) as unknown as GetContractReturnType<Abi, PublicClient, WalletClient>;
+
+  if (contract.write) {
+    // Replace write calls with our own. Implemented ~the same as viem, but adds better handling of nonces (via queue + retries).
+    contract.write = new Proxy(
+      {},
+      {
+        get(_, functionName: string) {
+          return (
+            ...parameters: [
+              args?: readonly unknown[],
+              options?: UnionOmit<WriteContractParameters, "abi" | "address" | "functionName" | "args">
+            ]
+          ) => {
+            const { args, options } = getFunctionParameters(parameters);
+            return writeContract(walletClient, {
+              abi,
+              address,
+              functionName,
+              args,
+              ...options,
+              onWrite,
+            } as unknown as WriteContractOptions<TAbi, typeof functionName, TChain, TAccount>);
+          };
+        },
+      }
+    );
+  }
+
+  return contract as unknown as GetContractReturnType<TAbi, TPublicClient, TWalletClient, TAddress>;
+}

package/src/getNonceManager.ts

@@ -0,0 +1,21 @@
+import { CreateNonceManagerOptions, CreateNonceManagerResult, createNonceManager } from "./createNonceManager";
+import { getNonceManagerId } from "./getNonceManagerId";
+
+const nonceManagers = new Map<string, CreateNonceManagerResult>();
+
+export async function getNonceManager({
+  client,
+  address,
+  blockTag = "latest",
+}: CreateNonceManagerOptions): Promise<CreateNonceManagerResult> {
+  const id = await getNonceManagerId({ client, address, blockTag });
+
+  const existingNonceManager = nonceManagers.get(id);
+  if (existingNonceManager) {
+    return existingNonceManager;
+  }
+
+  const nonceManager = createNonceManager({ client, address, blockTag });
+  nonceManagers.set(id, nonceManager);
+  return nonceManager;
+}

package/src/getNonceManagerId.ts

@@ -0,0 +1,15 @@
+import { BlockTag, Client, Hex, getAddress } from "viem";
+import { getChainId } from "viem/actions";
+
+export async function getNonceManagerId({
+  client,
+  address,
+  blockTag,
+}: {
+  client: Client;
+  address: Hex;
+  blockTag: BlockTag;
+}): Promise<string> {
+  const chainId = client.chain?.id ?? (await getChainId(client));
+  return `mud:createNonceManager:${chainId}:${getAddress(address)}:${blockTag}`;
+}

package/src/index.ts

@@ -1,11 +1,17 @@
 export * from "./common";
 export * from "./createBurnerAccount";
-export * from "./createContract";
 export * from "./createNonceManager";
+export * from "./getContract";
 export * from "./getBurnerPrivateKey";
+export * from "./getNonceManager";
+export * from "./getNonceManagerId";
 export * from "./hexToResourceId";
 export * from "./readHex";
 export * from "./resourceIdToHex";
 export * from "./resourceTypes";
 export * from "./spliceHex";
 export * from "./transportObserver";
+export * from "./writeContract";
+
+/** @deprecated use `getContract` instead */
+export { createContract } from "./createContract";

package/src/writeContract.ts

@@ -0,0 +1,120 @@
+import {
+  Abi,
+  Account,
+  Chain,
+  Client,
+  Hex,
+  SimulateContractParameters,
+  Transport,
+  WriteContractParameters,
+  WriteContractReturnType,
+} from "viem";
+import { simulateContract, writeContract as viem_writeContract } from "viem/actions";
+import pRetry from "p-retry";
+import { debug as parentDebug } from "./debug";
+import { getNonceManager } from "./getNonceManager";
+import { parseAccount } from "viem/accounts";
+
+const debug = parentDebug.extend("writeContract");
+let nextWriteId = 0;
+
+export type ContractWrite<
+  TAbi extends Abi | readonly unknown[] = Abi,
+  TFunctionName extends string = string,
+  TChain extends Chain | undefined = Chain,
+  TAccount extends Account | undefined = Account | undefined,
+  TChainOverride extends Chain | undefined = Chain | undefined
+> = {
+  id: string;
+  request: WriteContractParameters<TAbi, TFunctionName, TChain, TAccount, TChainOverride>;
+  result: Promise<Hex>;
+};
+
+export type WriteContractOptions<
+  TAbi extends Abi | readonly unknown[] = Abi,
+  TFunctionName extends string = string,
+  TChain extends Chain | undefined = Chain,
+  TAccount extends Account | undefined = Account | undefined,
+  TChainOverride extends Chain | undefined = Chain | undefined
+> = WriteContractParameters<TAbi, TFunctionName, TChain, TAccount, TChainOverride> & {
+  onWrite?: (write: ContractWrite<TAbi, TFunctionName, TChain, TAccount, TChainOverride>) => void;
+};
+
+// TODO: migrate away from this approach once we can hook into viem's nonce management: https://github.com/wagmi-dev/viem/discussions/1230
+
+export async function writeContract<
+  TChain extends Chain | undefined,
+  TAccount extends Account | undefined,
+  TAbi extends Abi | readonly unknown[],
+  TFunctionName extends string,
+  TChainOverride extends Chain | undefined
+>(
+  client: Client<Transport, TChain, TAccount>,
+  { onWrite, ...request_ }: WriteContractOptions<TAbi, TFunctionName, TChain, TAccount, TChainOverride>
+): Promise<WriteContractReturnType> {
+  const request = request_ as WriteContractParameters<TAbi, TFunctionName, TChain, TAccount, TChainOverride>;
+
+  const account_ = request.account ?? client.account;
+  if (!account_) {
+    // TODO: replace with viem AccountNotFoundError once its exported
+    throw new Error("No account provided");
+  }
+  const account = parseAccount(account_);
+
+  const nonceManager = await getNonceManager({
+    client,
+    address: account.address,
+  });
+
+  async function prepareWrite(): Promise<
+    WriteContractParameters<TAbi, TFunctionName, TChain, TAccount, TChainOverride>
+  > {
+    if (request.gas) {
+      debug("gas provided, skipping simulate", request);
+      return request;
+    }
+
+    debug("simulating write", request);
+    const result = await simulateContract<TChain, TAbi, TFunctionName, TChainOverride>(client, {
+      ...request,
+      account,
+    } as unknown as SimulateContractParameters<TAbi, TFunctionName, TChain, TChainOverride>);
+
+    return result.request as unknown as WriteContractParameters<TAbi, TFunctionName, TChain, TAccount, TChainOverride>;
+  }
+
+  async function write(): Promise<Hex> {
+    const preparedWrite = await prepareWrite();
+
+    return await pRetry(
+      async () => {
+        if (!nonceManager.hasNonce()) {
+          await nonceManager.resetNonce();
+        }
+
+        const nonce = nonceManager.nextNonce();
+        debug("calling write function with nonce", nonce, preparedWrite);
+        return await viem_writeContract(client, { nonce, ...preparedWrite } as typeof preparedWrite);
+      },
+      {
+        retries: 3,
+        onFailedAttempt: async (error) => {
+          // On nonce errors, reset the nonce and retry
+          if (nonceManager.shouldResetNonce(error)) {
+            debug("got nonce error, retrying", error);
+            await nonceManager.resetNonce();
+            return;
+          }
+          // TODO: prepareWrite again if there are gas errors?
+          throw error;
+        },
+      }
+    );
+  }
+
+  const result = write();
+
+  onWrite?.({ id: `${nextWriteId++}`, request, result });
+
+  return result;
+}