@aastar/sdk 0.14.0 → 0.14.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (812) hide show
  1. package/.eslintrc.js +28 -0
  2. package/.gitmodules +9 -0
  3. package/README.md +170 -0
  4. package/aastar-sdk.code-workspace +14 -0
  5. package/abis/BLSAggregator.json +572 -0
  6. package/abis/BLSValidator.json +26 -0
  7. package/abis/DVTValidator.json +370 -0
  8. package/abis/Eip7702Support.json +24 -0
  9. package/abis/EntryPoint.json +1379 -0
  10. package/abis/GToken.json +479 -0
  11. package/abis/GTokenStaking.json +944 -0
  12. package/abis/LegacyAccount.json +625 -0
  13. package/abis/MySBT.json +1586 -0
  14. package/abis/Paymaster.json +1205 -0
  15. package/abis/PaymasterFactory.json +650 -0
  16. package/abis/PaymasterV4_2.json +1183 -0
  17. package/abis/Registry.json +1636 -0
  18. package/abis/ReputationSystem.json +477 -0
  19. package/abis/SenderCreator.json +99 -0
  20. package/abis/Simple7702Account.json +395 -0
  21. package/abis/SimpleAccount.json +625 -0
  22. package/abis/SimpleAccountFactory.json +108 -0
  23. package/abis/SimpleAccountFactoryV08.json +87 -0
  24. package/abis/SimpleAccountV08.json +557 -0
  25. package/abis/SuperPaymaster.json +1399 -0
  26. package/abis/UserOperationLib.json +57 -0
  27. package/abis/aPNTs.json +1173 -0
  28. package/abis/xPNTsFactory.json +728 -0
  29. package/abis/xPNTsToken.json +1173 -0
  30. package/config/networks/README.md +54 -0
  31. package/config/networks/mainnet.env.example +39 -0
  32. package/config/networks/optimism-sepolia.env.example +35 -0
  33. package/config/networks/optimism.env.example +36 -0
  34. package/config/networks/sepolia.env.example +36 -0
  35. package/data/experiment_data.csv +36 -0
  36. package/data/industry_baseline_2025-12-23.json +154 -0
  37. package/data/industry_baseline_latest.json +154 -0
  38. package/docs/API_REFERENCE.md +796 -0
  39. package/docs/DAO_Mining_Distribution_Plan.md +522 -0
  40. package/docs/DOCUMENTATION_PLAN.md +455 -0
  41. package/docs/Plan.md +266 -0
  42. package/docs/Regression_Testing_Guide.md +70 -0
  43. package/docs/SDK_Optimization_Evaluation_Plan.md +51 -0
  44. package/docs/SEPOLIA_ENV_REFERENCE.md +51 -0
  45. package/docs/STAGE_3_SCENARIO_EXP_PLAN.md +77 -0
  46. package/docs/Script_Comparison_Report.md +91 -0
  47. package/docs/Sepolia_Latest_Deployment.md +117 -0
  48. package/docs/TEST_COVERAGE_MATRIX.md +72 -0
  49. package/docs/TODO_SDK_COVERAGE.md +55 -0
  50. package/docs/USER_CASE_DESIGN.md +110 -0
  51. package/docs/api/@aastar/account/README.md +15 -0
  52. package/docs/api/@aastar/account/classes/UserOpClient.md +87 -0
  53. package/docs/api/@aastar/account/functions/createEOAWalletClient.md +21 -0
  54. package/docs/api/@aastar/account/functions/getUserOpHash.md +23 -0
  55. package/docs/api/@aastar/account/functions/packUserOpLimits.md +19 -0
  56. package/docs/api/@aastar/account/functions/toSimpleSmartAccount.md +83 -0
  57. package/docs/api/@aastar/account/type-aliases/EOAWalletClient.md +37 -0
  58. package/docs/api/@aastar/account/type-aliases/SimpleSmartAccount.md +39 -0
  59. package/docs/api/@aastar/core/README.md +136 -0
  60. package/docs/api/@aastar/core/classes/BLSSigner.md +147 -0
  61. package/docs/api/@aastar/core/enumerations/NodeType.md +33 -0
  62. package/docs/api/@aastar/core/functions/aggregatorActions.md +2714 -0
  63. package/docs/api/@aastar/core/functions/createAAStarPublicClient.md +3105 -0
  64. package/docs/api/@aastar/core/functions/dvtActions.md +2714 -0
  65. package/docs/api/@aastar/core/functions/factoryActions.md +2714 -0
  66. package/docs/api/@aastar/core/functions/getAddressUrl.md +32 -0
  67. package/docs/api/@aastar/core/functions/getAllCommunityConfigs.md +9 -0
  68. package/docs/api/@aastar/core/functions/getAllV2Contracts.md +20 -0
  69. package/docs/api/@aastar/core/functions/getBlockExplorer.md +26 -0
  70. package/docs/api/@aastar/core/functions/getChainId.md +26 -0
  71. package/docs/api/@aastar/core/functions/getCommunities.md +76 -0
  72. package/docs/api/@aastar/core/functions/getCommunity.md +32 -0
  73. package/docs/api/@aastar/core/functions/getCommunityConfig.md +15 -0
  74. package/docs/api/@aastar/core/functions/getContract.md +37 -0
  75. package/docs/api/@aastar/core/functions/getContractNetworks.md +18 -0
  76. package/docs/api/@aastar/core/functions/getContracts.md +178 -0
  77. package/docs/api/@aastar/core/functions/getCoreContracts.md +55 -0
  78. package/docs/api/@aastar/core/functions/getDeploymentDate.md +32 -0
  79. package/docs/api/@aastar/core/functions/getEntryPoint.md +25 -0
  80. package/docs/api/@aastar/core/functions/getNetwork.md +26 -0
  81. package/docs/api/@aastar/core/functions/getPaymasterV4_1.md +25 -0
  82. package/docs/api/@aastar/core/functions/getRpcUrl.md +25 -0
  83. package/docs/api/@aastar/core/functions/getSimpleAccountFactory.md +25 -0
  84. package/docs/api/@aastar/core/functions/getSuperPaymasterV2.md +25 -0
  85. package/docs/api/@aastar/core/functions/getTestAccounts.md +30 -0
  86. package/docs/api/@aastar/core/functions/getTestTokenContracts.md +38 -0
  87. package/docs/api/@aastar/core/functions/getTokenContracts.md +31 -0
  88. package/docs/api/@aastar/core/functions/getTxUrl.md +32 -0
  89. package/docs/api/@aastar/core/functions/getV2ContractByAddress.md +28 -0
  90. package/docs/api/@aastar/core/functions/getV2ContractByName.md +28 -0
  91. package/docs/api/@aastar/core/functions/getV2ContractsByDate.md +26 -0
  92. package/docs/api/@aastar/core/functions/isContractNetworkSupported.md +27 -0
  93. package/docs/api/@aastar/core/functions/isRegisteredCommunity.md +15 -0
  94. package/docs/api/@aastar/core/functions/isV2Contract.md +27 -0
  95. package/docs/api/@aastar/core/functions/paymasterV4Actions.md +2719 -0
  96. package/docs/api/@aastar/core/functions/registryActions.md +2720 -0
  97. package/docs/api/@aastar/core/functions/reputationActions.md +2720 -0
  98. package/docs/api/@aastar/core/functions/sbtActions.md +2720 -0
  99. package/docs/api/@aastar/core/functions/stakingActions.md +2720 -0
  100. package/docs/api/@aastar/core/functions/superPaymasterActions.md +2720 -0
  101. package/docs/api/@aastar/core/functions/tokenActions.md +2714 -0
  102. package/docs/api/@aastar/core/interfaces/CommunityConfig.md +81 -0
  103. package/docs/api/@aastar/core/interfaces/ContractVersion.md +63 -0
  104. package/docs/api/@aastar/core/type-aliases/AggregatorActions.md +79 -0
  105. package/docs/api/@aastar/core/type-aliases/ContractCategory.md +5 -0
  106. package/docs/api/@aastar/core/type-aliases/ContractNetwork.md +5 -0
  107. package/docs/api/@aastar/core/type-aliases/DVTActions.md +139 -0
  108. package/docs/api/@aastar/core/type-aliases/FactoryActions.md +99 -0
  109. package/docs/api/@aastar/core/type-aliases/NetworkContracts.md +5 -0
  110. package/docs/api/@aastar/core/type-aliases/PaymasterV4Actions.md +422 -0
  111. package/docs/api/@aastar/core/type-aliases/RegistryActions.md +263 -0
  112. package/docs/api/@aastar/core/type-aliases/ReputationActions.md +47 -0
  113. package/docs/api/@aastar/core/type-aliases/RoleConfig.md +83 -0
  114. package/docs/api/@aastar/core/type-aliases/SBTActions.md +203 -0
  115. package/docs/api/@aastar/core/type-aliases/StakingActions.md +179 -0
  116. package/docs/api/@aastar/core/type-aliases/SuperPaymasterActions.md +219 -0
  117. package/docs/api/@aastar/core/type-aliases/SupportedNetwork.md +3 -0
  118. package/docs/api/@aastar/core/type-aliases/TokenActions.md +151 -0
  119. package/docs/api/@aastar/core/variables/AASTAR_COMMUNITY.md +8 -0
  120. package/docs/api/@aastar/core/variables/ALL_ADDRESSES.md +71 -0
  121. package/docs/api/@aastar/core/variables/BLSAggregatorABI.md +3 -0
  122. package/docs/api/@aastar/core/variables/BLSHelpers.md +91 -0
  123. package/docs/api/@aastar/core/variables/BPS_DENOMINATOR.md +5 -0
  124. package/docs/api/@aastar/core/variables/BRANDING.md +67 -0
  125. package/docs/api/@aastar/core/variables/BREAD_COMMUNITY.md +8 -0
  126. package/docs/api/@aastar/core/variables/COMMUNITIES.md +5 -0
  127. package/docs/api/@aastar/core/variables/COMMUNITY_OWNERS.md +15 -0
  128. package/docs/api/@aastar/core/variables/CONTRACTS.md +163 -0
  129. package/docs/api/@aastar/core/variables/CONTRACT_METADATA.md +67 -0
  130. package/docs/api/@aastar/core/variables/CORE_ADDRESSES.md +35 -0
  131. package/docs/api/@aastar/core/variables/DEFAULT_APNTS_PRICE_USD.md +5 -0
  132. package/docs/api/@aastar/core/variables/DEFAULT_GAS_TOKEN_MINT_AMOUNT.md +5 -0
  133. package/docs/api/@aastar/core/variables/DEFAULT_USDT_MINT_AMOUNT.md +5 -0
  134. package/docs/api/@aastar/core/variables/DVTValidatorABI.md +3 -0
  135. package/docs/api/@aastar/core/variables/EntryPointABI.md +3 -0
  136. package/docs/api/@aastar/core/variables/FAUCET_API_URL.md +5 -0
  137. package/docs/api/@aastar/core/variables/GTokenABI.md +3 -0
  138. package/docs/api/@aastar/core/variables/GTokenStakingABI.md +3 -0
  139. package/docs/api/@aastar/core/variables/LINKS.md +33 -0
  140. package/docs/api/@aastar/core/variables/MAX_SERVICE_FEE.md +5 -0
  141. package/docs/api/@aastar/core/variables/MONITORING_ADDRESSES.md +15 -0
  142. package/docs/api/@aastar/core/variables/MySBTABI.md +3 -0
  143. package/docs/api/@aastar/core/variables/NETWORKS.md +79 -0
  144. package/docs/api/@aastar/core/variables/NODE_STAKE_AMOUNTS.md +31 -0
  145. package/docs/api/@aastar/core/variables/OFFICIAL_ADDRESSES.md +11 -0
  146. package/docs/api/@aastar/core/variables/PAYMASTER_ADDRESSES.md +15 -0
  147. package/docs/api/@aastar/core/variables/PaymasterABI.md +3 -0
  148. package/docs/api/@aastar/core/variables/PaymasterFactoryABI.md +3 -0
  149. package/docs/api/@aastar/core/variables/PaymasterV4ABI.md +3 -0
  150. package/docs/api/@aastar/core/variables/ROLE_ANODE.md +3 -0
  151. package/docs/api/@aastar/core/variables/ROLE_COMMUNITY.md +3 -0
  152. package/docs/api/@aastar/core/variables/ROLE_ENDUSER.md +5 -0
  153. package/docs/api/@aastar/core/variables/ROLE_KMS.md +3 -0
  154. package/docs/api/@aastar/core/variables/ROLE_PAYMASTER_AOA.md +3 -0
  155. package/docs/api/@aastar/core/variables/ROLE_PAYMASTER_SUPER.md +3 -0
  156. package/docs/api/@aastar/core/variables/RegistryABI.md +3 -0
  157. package/docs/api/@aastar/core/variables/ReputationSystemABI.md +3 -0
  158. package/docs/api/@aastar/core/variables/ReputationSystemV3ABI.md +3 -0
  159. package/docs/api/@aastar/core/variables/SEPOLIA_CONTRACTS.md +159 -0
  160. package/docs/api/@aastar/core/variables/SEPOLIA_V2_VERSIONS.md +67 -0
  161. package/docs/api/@aastar/core/variables/SERVICE_FEE_RATE.md +5 -0
  162. package/docs/api/@aastar/core/variables/Simple7702AccountABI.md +3 -0
  163. package/docs/api/@aastar/core/variables/SimpleAccountABI.md +3 -0
  164. package/docs/api/@aastar/core/variables/SimpleAccountFactoryABI.md +3 -0
  165. package/docs/api/@aastar/core/variables/SimpleAccountFactoryV08ABI.md +3 -0
  166. package/docs/api/@aastar/core/variables/SimpleAccountV08ABI.md +3 -0
  167. package/docs/api/@aastar/core/variables/SuperPaymasterABI.md +3 -0
  168. package/docs/api/@aastar/core/variables/SuperPaymasterV3ABI.md +3 -0
  169. package/docs/api/@aastar/core/variables/TEST_ACCOUNT_ADDRESSES.md +11 -0
  170. package/docs/api/@aastar/core/variables/TEST_ACCOUNT_POOL_SIZE.md +5 -0
  171. package/docs/api/@aastar/core/variables/TEST_COMMUNITIES.md +19 -0
  172. package/docs/api/@aastar/core/variables/TEST_TOKEN_ADDRESSES.md +19 -0
  173. package/docs/api/@aastar/core/variables/TOKEN_ADDRESSES.md +11 -0
  174. package/docs/api/@aastar/core/variables/V2_SUMMARY.md +39 -0
  175. package/docs/api/@aastar/core/variables/xPNTsFactoryABI.md +3 -0
  176. package/docs/api/@aastar/core/variables/xPNTsTokenABI.md +3 -0
  177. package/docs/api/@aastar/paymaster/README.md +14 -0
  178. package/docs/api/@aastar/paymaster/classes/SuperPaymasterClient.md +163 -0
  179. package/docs/api/@aastar/paymaster/functions/checkEligibility.md +28 -0
  180. package/docs/api/@aastar/paymaster/functions/getPaymasterV4Middleware.md +32 -0
  181. package/docs/api/@aastar/paymaster/functions/getSuperPaymasterMiddleware.md +32 -0
  182. package/docs/api/@aastar/paymaster/type-aliases/PaymasterConfig.md +35 -0
  183. package/docs/api/@aastar/paymaster/type-aliases/PaymasterV4MiddlewareConfig.md +35 -0
  184. package/docs/api/@aastar/tokens/README.md +3 -0
  185. package/docs/api/@aastar/tokens/classes/FinanceClient.md +8653 -0
  186. package/docs/api/README.md +6 -0
  187. package/docs/examples/community-flow.md +28 -0
  188. package/docs/examples/enduser-flow.md +24 -0
  189. package/docs/examples/index.md +18 -0
  190. package/docs/examples/multi-chain.md +31 -0
  191. package/docs/examples/operator-flow.md +28 -0
  192. package/docs/guide/CLI_GUIDE.md +65 -0
  193. package/docs/guide/DOCUMENTATION_PLAN.md +455 -0
  194. package/docs/guide/Security-solution.md +106 -0
  195. package/docs/guide/TEST_COMMANDS.md +320 -0
  196. package/docs/guide/getting-started.md +133 -0
  197. package/docs/guide/installation.md +40 -0
  198. package/docs/guide/paper-data-collection.md +69 -0
  199. package/docs/guide/quick-start.md +52 -0
  200. package/docs/guide/task_breakdown.md +121 -0
  201. package/docs/old-solution.md +1078 -0
  202. package/docs/paper-data-collection.md +69 -0
  203. package/docs/technical_plan.md +510 -0
  204. package/docs/zh/examples/community-flow.md +38 -0
  205. package/docs/zh/examples/complete-workflow.md +10 -0
  206. package/docs/zh/examples/enduser-flow.md +33 -0
  207. package/docs/zh/examples/index.md +18 -0
  208. package/docs/zh/examples/multi-chain.md +46 -0
  209. package/docs/zh/examples/operator-flow.md +37 -0
  210. package/docs/zh/guide/CLI_GUIDE.md +48 -0
  211. package/docs/zh/guide/DOCUMENTATION_PLAN.md +455 -0
  212. package/docs/zh/guide/Plan.md +266 -0
  213. package/docs/zh/guide/SDK_Optimization_Evaluation_Plan.md +51 -0
  214. package/docs/zh/guide/Security-solution.md +106 -0
  215. package/docs/zh/guide/TEST_COMMANDS.md +125 -0
  216. package/docs/zh/guide/TEST_COVERAGE_MATRIX.md +72 -0
  217. package/docs/zh/guide/concepts/account-abstraction.md +95 -0
  218. package/docs/zh/guide/concepts/rainbow-bridge.md +68 -0
  219. package/docs/zh/guide/concepts/reputation.md +95 -0
  220. package/docs/zh/guide/concepts/superpaymaster.md +141 -0
  221. package/docs/zh/guide/getting-started.md +133 -0
  222. package/docs/zh/guide/installation.md +107 -0
  223. package/docs/zh/guide/old-solution.md +1078 -0
  224. package/docs/zh/guide/paper-data-collection.md +69 -0
  225. package/docs/zh/guide/quick-start.md +134 -0
  226. package/docs/zh/guide/sdk-readme.md +253 -0
  227. package/docs/zh/guide/task_breakdown.md +76 -0
  228. package/docs/zh/guide/technical_plan.md +510 -0
  229. package/docs/zh/guide/use-cases/community-management.md +141 -0
  230. package/docs/zh/guide/use-cases/gasless-transactions.md +71 -0
  231. package/docs/zh/guide/use-cases/operator-staking.md +84 -0
  232. package/docs/zh/guide/use-cases/yop.md +72 -0
  233. package/examples/sdk-demo/DEVELOPER_GUIDE.md +159 -0
  234. package/examples/sdk-demo/README.md +30 -0
  235. package/examples/sdk-demo/usage.ts +137 -0
  236. package/ext/aastar-shared-config/.env.example +6 -0
  237. package/ext/aastar-shared-config/.github/workflows/check-secrets.yml +257 -0
  238. package/ext/aastar-shared-config/AGENTS.md +21 -0
  239. package/ext/aastar-shared-config/CHANGELOG.md +99 -0
  240. package/ext/aastar-shared-config/LICENSE +21 -0
  241. package/ext/aastar-shared-config/QUICK_START.md +215 -0
  242. package/ext/aastar-shared-config/README.md +412 -0
  243. package/ext/aastar-shared-config/SHARED_CONFIG_SUMMARY.md +273 -0
  244. package/ext/aastar-shared-config/check-locker-status.mjs +7 -0
  245. package/ext/aastar-shared-config/favicon.ico +0 -0
  246. package/ext/aastar-shared-config/generate-comparison-table.sh +67 -0
  247. package/ext/aastar-shared-config/package.json +46 -0
  248. package/ext/aastar-shared-config/pnpm-lock.yaml +1182 -0
  249. package/ext/aastar-shared-config/src/abis/BLSAggregator.json +1 -0
  250. package/ext/aastar-shared-config/src/abis/DVTValidator.json +1 -0
  251. package/ext/aastar-shared-config/src/abis/GToken.json +1 -0
  252. package/ext/aastar-shared-config/src/abis/GTokenStaking.json +1 -0
  253. package/ext/aastar-shared-config/src/abis/MySBT.json +1 -0
  254. package/ext/aastar-shared-config/src/abis/PaymasterFactory.json +1 -0
  255. package/ext/aastar-shared-config/src/abis/PaymasterV4.json +1098 -0
  256. package/ext/aastar-shared-config/src/abis/Registry.json +1 -0
  257. package/ext/aastar-shared-config/src/abis/SimpleAccount.json +557 -0
  258. package/ext/aastar-shared-config/src/abis/SimpleAccountFactory.json +87 -0
  259. package/ext/aastar-shared-config/src/abis/SuperPaymasterV2.json +1 -0
  260. package/ext/aastar-shared-config/src/abis/index.ts +45 -0
  261. package/ext/aastar-shared-config/src/abis/xPNTsFactory.json +1 -0
  262. package/ext/aastar-shared-config/src/abis/xPNTsToken.json +1 -0
  263. package/ext/aastar-shared-config/src/branding.ts +32 -0
  264. package/ext/aastar-shared-config/src/communities.ts +93 -0
  265. package/ext/aastar-shared-config/src/constants.ts +67 -0
  266. package/ext/aastar-shared-config/src/contract-addresses.ts +95 -0
  267. package/ext/aastar-shared-config/src/contract-versions.ts +374 -0
  268. package/ext/aastar-shared-config/src/contracts.ts +414 -0
  269. package/ext/aastar-shared-config/src/index.ts +14 -0
  270. package/ext/aastar-shared-config/src/networks.ts +117 -0
  271. package/ext/aastar-shared-config/sync-abis.sh +92 -0
  272. package/ext/aastar-shared-config/sync-versions.mjs +150 -0
  273. package/ext/aastar-shared-config/tsconfig.json +18 -0
  274. package/ext/aastar-shared-config/tsup.config.ts +10 -0
  275. package/ext/aastar-shared-config/verify-all.sh +207 -0
  276. package/ext/aastar-shared-config/verify-contracts.sh +85 -0
  277. package/ext/aastar-shared-config/verify-mysbt-v243.mjs +27 -0
  278. package/ext/aastar-shared-config/verify-onchain-versions.mjs +93 -0
  279. package/ext/permissionless.js/.changeset/README.md +8 -0
  280. package/ext/permissionless.js/.changeset/config.json +11 -0
  281. package/ext/permissionless.js/.env-example +2 -0
  282. package/ext/permissionless.js/.github/actions/install-dependencies/action.yml +17 -0
  283. package/ext/permissionless.js/.github/dependabot.yaml +10 -0
  284. package/ext/permissionless.js/.github/workflows/canary.yml +49 -0
  285. package/ext/permissionless.js/.github/workflows/on-pull-request.yml +61 -0
  286. package/ext/permissionless.js/.github/workflows/on-push-to-main.yml +59 -0
  287. package/ext/permissionless.js/.github/workflows/prune-tags.yml +92 -0
  288. package/ext/permissionless.js/.github/workflows/verify.yml +114 -0
  289. package/ext/permissionless.js/.size-limit.json +13 -0
  290. package/ext/permissionless.js/LICENSE +21 -0
  291. package/ext/permissionless.js/assets/banner.png +0 -0
  292. package/ext/permissionless.js/biome.json +46 -0
  293. package/ext/permissionless.js/bun.lock +2340 -0
  294. package/ext/permissionless.js/bun.lockb +0 -0
  295. package/ext/permissionless.js/package.json +82 -0
  296. package/ext/permissionless.js/packages/mock-paymaster/CHANGELOG.md +31 -0
  297. package/ext/permissionless.js/packages/mock-paymaster/constants.ts +84 -0
  298. package/ext/permissionless.js/packages/mock-paymaster/helpers/abi.ts +1048 -0
  299. package/ext/permissionless.js/packages/mock-paymaster/helpers/erc20-utils.ts +105 -0
  300. package/ext/permissionless.js/packages/mock-paymaster/helpers/schema.ts +307 -0
  301. package/ext/permissionless.js/packages/mock-paymaster/helpers/utils.ts +78 -0
  302. package/ext/permissionless.js/packages/mock-paymaster/index.ts +63 -0
  303. package/ext/permissionless.js/packages/mock-paymaster/package.json +33 -0
  304. package/ext/permissionless.js/packages/mock-paymaster/relay.ts +424 -0
  305. package/ext/permissionless.js/packages/mock-paymaster/setup.ts +163 -0
  306. package/ext/permissionless.js/packages/mock-paymaster/singletonPaymasters.ts +230 -0
  307. package/ext/permissionless.js/packages/permissionless/CHANGELOG.md +893 -0
  308. package/ext/permissionless.js/packages/permissionless/README.md +122 -0
  309. package/ext/permissionless.js/packages/permissionless/accounts/biconomy/abi/BiconomySmartAccountAbi.ts +128 -0
  310. package/ext/permissionless.js/packages/permissionless/accounts/biconomy/toBiconomySmartAccount.ts +374 -0
  311. package/ext/permissionless.js/packages/permissionless/accounts/decodeCalls.test.ts +505 -0
  312. package/ext/permissionless.js/packages/permissionless/accounts/etherspot/abi/EtherspotBootstrapAbi.ts +94 -0
  313. package/ext/permissionless.js/packages/permissionless/accounts/etherspot/constants.ts +27 -0
  314. package/ext/permissionless.js/packages/permissionless/accounts/etherspot/toEtherspotSmartAccount.ts +369 -0
  315. package/ext/permissionless.js/packages/permissionless/accounts/etherspot/utils/getInitMSAData.ts +56 -0
  316. package/ext/permissionless.js/packages/permissionless/accounts/etherspot/utils/getNonceKey.ts +21 -0
  317. package/ext/permissionless.js/packages/permissionless/accounts/etherspot/utils/wrapMessageHash.ts +43 -0
  318. package/ext/permissionless.js/packages/permissionless/accounts/index.ts +86 -0
  319. package/ext/permissionless.js/packages/permissionless/accounts/kernel/abi/KernelAccountAbi.ts +87 -0
  320. package/ext/permissionless.js/packages/permissionless/accounts/kernel/abi/KernelV3AccountAbi.ts +813 -0
  321. package/ext/permissionless.js/packages/permissionless/accounts/kernel/abi/KernelV3FactoryAbi.ts +12 -0
  322. package/ext/permissionless.js/packages/permissionless/accounts/kernel/abi/KernelV3MetaFactoryAbi.ts +17 -0
  323. package/ext/permissionless.js/packages/permissionless/accounts/kernel/constants.ts +14 -0
  324. package/ext/permissionless.js/packages/permissionless/accounts/kernel/to7702KernelSmartAccount.ts +63 -0
  325. package/ext/permissionless.js/packages/permissionless/accounts/kernel/toEcdsaKernelSmartAccount.ts +62 -0
  326. package/ext/permissionless.js/packages/permissionless/accounts/kernel/toKernelSmartAccount.ts +984 -0
  327. package/ext/permissionless.js/packages/permissionless/accounts/kernel/utils/decodeCallData.ts +43 -0
  328. package/ext/permissionless.js/packages/permissionless/accounts/kernel/utils/encodeCallData.ts +57 -0
  329. package/ext/permissionless.js/packages/permissionless/accounts/kernel/utils/getNonceKey.ts +33 -0
  330. package/ext/permissionless.js/packages/permissionless/accounts/kernel/utils/isKernelV2.ts +6 -0
  331. package/ext/permissionless.js/packages/permissionless/accounts/kernel/utils/isWebAuthnAccount.ts +8 -0
  332. package/ext/permissionless.js/packages/permissionless/accounts/kernel/utils/signMessage.ts +115 -0
  333. package/ext/permissionless.js/packages/permissionless/accounts/kernel/utils/signTypedData.ts +97 -0
  334. package/ext/permissionless.js/packages/permissionless/accounts/kernel/utils/wrapMessageHash.ts +44 -0
  335. package/ext/permissionless.js/packages/permissionless/accounts/light/toLightSmartAccount.ts +496 -0
  336. package/ext/permissionless.js/packages/permissionless/accounts/nexus/toNexusSmartAccount.ts +351 -0
  337. package/ext/permissionless.js/packages/permissionless/accounts/safe/index.ts +14 -0
  338. package/ext/permissionless.js/packages/permissionless/accounts/safe/signUserOperation.test.ts +275 -0
  339. package/ext/permissionless.js/packages/permissionless/accounts/safe/signUserOperation.ts +316 -0
  340. package/ext/permissionless.js/packages/permissionless/accounts/safe/toSafeSmartAccount.ts +1980 -0
  341. package/ext/permissionless.js/packages/permissionless/accounts/simple/to7702SimpleSmartAccount.ts +51 -0
  342. package/ext/permissionless.js/packages/permissionless/accounts/simple/toSimpleSmartAccount.ts +585 -0
  343. package/ext/permissionless.js/packages/permissionless/accounts/thirdweb/toThirdwebSmartAccount.ts +221 -0
  344. package/ext/permissionless.js/packages/permissionless/accounts/thirdweb/utils/decodeCallData.ts +87 -0
  345. package/ext/permissionless.js/packages/permissionless/accounts/thirdweb/utils/encodeCallData.ts +81 -0
  346. package/ext/permissionless.js/packages/permissionless/accounts/thirdweb/utils/getAccountAddress.ts +48 -0
  347. package/ext/permissionless.js/packages/permissionless/accounts/thirdweb/utils/getFactoryData.ts +40 -0
  348. package/ext/permissionless.js/packages/permissionless/accounts/thirdweb/utils/signMessage.ts +33 -0
  349. package/ext/permissionless.js/packages/permissionless/accounts/thirdweb/utils/signTypedData.ts +67 -0
  350. package/ext/permissionless.js/packages/permissionless/accounts/trust/toTrustSmartAccount.ts +232 -0
  351. package/ext/permissionless.js/packages/permissionless/accounts/trust/utils/decodeCallData.ts +87 -0
  352. package/ext/permissionless.js/packages/permissionless/accounts/trust/utils/encodeCallData.ts +81 -0
  353. package/ext/permissionless.js/packages/permissionless/accounts/trust/utils/getFactoryData.ts +51 -0
  354. package/ext/permissionless.js/packages/permissionless/actions/erc7579/accountId.test.ts +39 -0
  355. package/ext/permissionless.js/packages/permissionless/actions/erc7579/accountId.ts +93 -0
  356. package/ext/permissionless.js/packages/permissionless/actions/erc7579/installModule.test.ts +216 -0
  357. package/ext/permissionless.js/packages/permissionless/actions/erc7579/installModule.ts +99 -0
  358. package/ext/permissionless.js/packages/permissionless/actions/erc7579/installModules.test.ts +237 -0
  359. package/ext/permissionless.js/packages/permissionless/actions/erc7579/installModules.ts +96 -0
  360. package/ext/permissionless.js/packages/permissionless/actions/erc7579/isModuleInstalled.test.ts +72 -0
  361. package/ext/permissionless.js/packages/permissionless/actions/erc7579/isModuleInstalled.ts +132 -0
  362. package/ext/permissionless.js/packages/permissionless/actions/erc7579/supportsExecutionMode.test.ts +108 -0
  363. package/ext/permissionless.js/packages/permissionless/actions/erc7579/supportsExecutionMode.ts +158 -0
  364. package/ext/permissionless.js/packages/permissionless/actions/erc7579/supportsModule.test.ts +35 -0
  365. package/ext/permissionless.js/packages/permissionless/actions/erc7579/supportsModule.ts +120 -0
  366. package/ext/permissionless.js/packages/permissionless/actions/erc7579/uninstallModule.test.ts +129 -0
  367. package/ext/permissionless.js/packages/permissionless/actions/erc7579/uninstallModule.ts +98 -0
  368. package/ext/permissionless.js/packages/permissionless/actions/erc7579/uninstallModules.test.ts +117 -0
  369. package/ext/permissionless.js/packages/permissionless/actions/erc7579/uninstallModules.ts +87 -0
  370. package/ext/permissionless.js/packages/permissionless/actions/erc7579.ts +103 -0
  371. package/ext/permissionless.js/packages/permissionless/actions/etherspot/getUserOperationGasPrice.ts +32 -0
  372. package/ext/permissionless.js/packages/permissionless/actions/etherspot.ts +4 -0
  373. package/ext/permissionless.js/packages/permissionless/actions/index.ts +9 -0
  374. package/ext/permissionless.js/packages/permissionless/actions/package.json +6 -0
  375. package/ext/permissionless.js/packages/permissionless/actions/passkeyServer/getCredentials.ts +47 -0
  376. package/ext/permissionless.js/packages/permissionless/actions/passkeyServer/startAuthentication.ts +39 -0
  377. package/ext/permissionless.js/packages/permissionless/actions/passkeyServer/startRegistration.ts +126 -0
  378. package/ext/permissionless.js/packages/permissionless/actions/passkeyServer/verifyAuthentication.ts +142 -0
  379. package/ext/permissionless.js/packages/permissionless/actions/passkeyServer/verifyRegistration.ts +132 -0
  380. package/ext/permissionless.js/packages/permissionless/actions/passkeyServer.ts +17 -0
  381. package/ext/permissionless.js/packages/permissionless/actions/pimlico/estimateErc20PaymasterCost.ts +102 -0
  382. package/ext/permissionless.js/packages/permissionless/actions/pimlico/getTokenQuotes.test.ts +90 -0
  383. package/ext/permissionless.js/packages/permissionless/actions/pimlico/getTokenQuotes.ts +77 -0
  384. package/ext/permissionless.js/packages/permissionless/actions/pimlico/getUserOperationGasPrice.test.ts +82 -0
  385. package/ext/permissionless.js/packages/permissionless/actions/pimlico/getUserOperationGasPrice.ts +67 -0
  386. package/ext/permissionless.js/packages/permissionless/actions/pimlico/getUserOperationStatus.test.ts +199 -0
  387. package/ext/permissionless.js/packages/permissionless/actions/pimlico/getUserOperationStatus.ts +49 -0
  388. package/ext/permissionless.js/packages/permissionless/actions/pimlico/sendCompressedUserOperation.ts +59 -0
  389. package/ext/permissionless.js/packages/permissionless/actions/pimlico/sponsorUserOperation.test.ts +236 -0
  390. package/ext/permissionless.js/packages/permissionless/actions/pimlico/sponsorUserOperation.ts +151 -0
  391. package/ext/permissionless.js/packages/permissionless/actions/pimlico/validateSponsorshipPolicies.test.ts +153 -0
  392. package/ext/permissionless.js/packages/permissionless/actions/pimlico/validateSponsorshipPolicies.ts +74 -0
  393. package/ext/permissionless.js/packages/permissionless/actions/pimlico.ts +38 -0
  394. package/ext/permissionless.js/packages/permissionless/actions/public/getAccountNonce.test.ts +96 -0
  395. package/ext/permissionless.js/packages/permissionless/actions/public/getAccountNonce.ts +75 -0
  396. package/ext/permissionless.js/packages/permissionless/actions/public/getSenderAddress.test.ts +154 -0
  397. package/ext/permissionless.js/packages/permissionless/actions/public/getSenderAddress.ts +129 -0
  398. package/ext/permissionless.js/packages/permissionless/actions/smartAccount/getCallsStatus.test.ts +255 -0
  399. package/ext/permissionless.js/packages/permissionless/actions/smartAccount/getCallsStatus.ts +91 -0
  400. package/ext/permissionless.js/packages/permissionless/actions/smartAccount/sendCalls.test.ts +571 -0
  401. package/ext/permissionless.js/packages/permissionless/actions/smartAccount/sendCalls.ts +38 -0
  402. package/ext/permissionless.js/packages/permissionless/actions/smartAccount/sendTransaction.test.ts +416 -0
  403. package/ext/permissionless.js/packages/permissionless/actions/smartAccount/sendTransaction.ts +133 -0
  404. package/ext/permissionless.js/packages/permissionless/actions/smartAccount/signMessage.test.ts +219 -0
  405. package/ext/permissionless.js/packages/permissionless/actions/smartAccount/signMessage.ts +73 -0
  406. package/ext/permissionless.js/packages/permissionless/actions/smartAccount/signTypedData.test.ts +228 -0
  407. package/ext/permissionless.js/packages/permissionless/actions/smartAccount/signTypedData.ts +157 -0
  408. package/ext/permissionless.js/packages/permissionless/actions/smartAccount/writeContract.ts +70 -0
  409. package/ext/permissionless.js/packages/permissionless/actions/smartAccount.ts +7 -0
  410. package/ext/permissionless.js/packages/permissionless/clients/createSmartAccountClient.ts +181 -0
  411. package/ext/permissionless.js/packages/permissionless/clients/decorators/passkeyServer.ts +57 -0
  412. package/ext/permissionless.js/packages/permissionless/clients/decorators/pimlico.ts +189 -0
  413. package/ext/permissionless.js/packages/permissionless/clients/decorators/smartAccount.ts +350 -0
  414. package/ext/permissionless.js/packages/permissionless/clients/index.ts +2 -0
  415. package/ext/permissionless.js/packages/permissionless/clients/passkeyServer.ts +69 -0
  416. package/ext/permissionless.js/packages/permissionless/clients/pimlico.ts +124 -0
  417. package/ext/permissionless.js/packages/permissionless/errors/index.ts +17 -0
  418. package/ext/permissionless.js/packages/permissionless/experimental/pimlico/index.ts +1 -0
  419. package/ext/permissionless.js/packages/permissionless/experimental/pimlico/utils/prepareUserOperationForErc20Paymaster.test.ts +523 -0
  420. package/ext/permissionless.js/packages/permissionless/experimental/pimlico/utils/prepareUserOperationForErc20Paymaster.ts +369 -0
  421. package/ext/permissionless.js/packages/permissionless/index.ts +3 -0
  422. package/ext/permissionless.js/packages/permissionless/package.json +102 -0
  423. package/ext/permissionless.js/packages/permissionless/types/etherspot.ts +12 -0
  424. package/ext/permissionless.js/packages/permissionless/types/package.json +6 -0
  425. package/ext/permissionless.js/packages/permissionless/types/passkeyServer.ts +125 -0
  426. package/ext/permissionless.js/packages/permissionless/types/pimlico.ts +151 -0
  427. package/ext/permissionless.js/packages/permissionless/utils/decode7579Calls.ts +133 -0
  428. package/ext/permissionless.js/packages/permissionless/utils/decodeNonce.test.ts +40 -0
  429. package/ext/permissionless.js/packages/permissionless/utils/decodeNonce.ts +10 -0
  430. package/ext/permissionless.js/packages/permissionless/utils/deepHexlify.test.ts +57 -0
  431. package/ext/permissionless.js/packages/permissionless/utils/deepHexlify.ts +35 -0
  432. package/ext/permissionless.js/packages/permissionless/utils/encode7579Calls.test.ts +69 -0
  433. package/ext/permissionless.js/packages/permissionless/utils/encode7579Calls.ts +114 -0
  434. package/ext/permissionless.js/packages/permissionless/utils/encodeInstallModule.ts +91 -0
  435. package/ext/permissionless.js/packages/permissionless/utils/encodeNonce.test.ts +38 -0
  436. package/ext/permissionless.js/packages/permissionless/utils/encodeNonce.ts +8 -0
  437. package/ext/permissionless.js/packages/permissionless/utils/encodeUninstallModule.ts +88 -0
  438. package/ext/permissionless.js/packages/permissionless/utils/erc20AllowanceOverride.test.ts +59 -0
  439. package/ext/permissionless.js/packages/permissionless/utils/erc20AllowanceOverride.ts +66 -0
  440. package/ext/permissionless.js/packages/permissionless/utils/erc20BalanceOverride.test.ts +57 -0
  441. package/ext/permissionless.js/packages/permissionless/utils/erc20BalanceOverride.ts +49 -0
  442. package/ext/permissionless.js/packages/permissionless/utils/getAddressFromInitCodeOrPaymasterAndData.test.ts +31 -0
  443. package/ext/permissionless.js/packages/permissionless/utils/getAddressFromInitCodeOrPaymasterAndData.ts +13 -0
  444. package/ext/permissionless.js/packages/permissionless/utils/getEstimationCallData.ts +297 -0
  445. package/ext/permissionless.js/packages/permissionless/utils/getPackedUserOperation.test.ts +204 -0
  446. package/ext/permissionless.js/packages/permissionless/utils/getPackedUserOperation.ts +122 -0
  447. package/ext/permissionless.js/packages/permissionless/utils/getRequiredPrefund.test.ts +90 -0
  448. package/ext/permissionless.js/packages/permissionless/utils/getRequiredPrefund.ts +56 -0
  449. package/ext/permissionless.js/packages/permissionless/utils/index.ts +43 -0
  450. package/ext/permissionless.js/packages/permissionless/utils/isSmartAccountDeployed.ts +13 -0
  451. package/ext/permissionless.js/packages/permissionless/utils/ox.ts +48 -0
  452. package/ext/permissionless.js/packages/permissionless/utils/toOwner.ts +89 -0
  453. package/ext/permissionless.js/packages/permissionless/vitest.config.ts +31 -0
  454. package/ext/permissionless.js/packages/permissionless-test/mock-aa-infra/alto/constants/accounts/biconomy.ts +22 -0
  455. package/ext/permissionless.js/packages/permissionless-test/mock-aa-infra/alto/constants/accounts/etherspot.ts +12 -0
  456. package/ext/permissionless.js/packages/permissionless-test/mock-aa-infra/alto/constants/accounts/kernel.ts +63 -0
  457. package/ext/permissionless.js/packages/permissionless-test/mock-aa-infra/alto/constants/accounts/light.ts +10 -0
  458. package/ext/permissionless.js/packages/permissionless-test/mock-aa-infra/alto/constants/accounts/nexus.ts +16 -0
  459. package/ext/permissionless.js/packages/permissionless-test/mock-aa-infra/alto/constants/accounts/safe.ts +75 -0
  460. package/ext/permissionless.js/packages/permissionless-test/mock-aa-infra/alto/constants/accounts/simple.ts +16 -0
  461. package/ext/permissionless.js/packages/permissionless-test/mock-aa-infra/alto/constants/accounts/thirdweb.ts +7 -0
  462. package/ext/permissionless.js/packages/permissionless-test/mock-aa-infra/alto/constants/accounts/trust.ts +26 -0
  463. package/ext/permissionless.js/packages/permissionless-test/mock-aa-infra/alto/constants/core.ts +24 -0
  464. package/ext/permissionless.js/packages/permissionless-test/mock-aa-infra/alto/constants/index.ts +10 -0
  465. package/ext/permissionless.js/packages/permissionless-test/mock-aa-infra/alto/index.ts +783 -0
  466. package/ext/permissionless.js/packages/permissionless-test/mock-aa-infra/alto/instance.ts +290 -0
  467. package/ext/permissionless.js/packages/permissionless-test/src/testWithRpc.ts +128 -0
  468. package/ext/permissionless.js/packages/permissionless-test/src/types.ts +12 -0
  469. package/ext/permissionless.js/packages/permissionless-test/src/utils.ts +1091 -0
  470. package/ext/permissionless.js/packages/wagmi/CHANGELOG.md +53 -0
  471. package/ext/permissionless.js/packages/wagmi/README.md +93 -0
  472. package/ext/permissionless.js/packages/wagmi/context.ts +22 -0
  473. package/ext/permissionless.js/packages/wagmi/hooks/useAvailableCapabilities.ts +43 -0
  474. package/ext/permissionless.js/packages/wagmi/hooks/useSendTransaction.ts +164 -0
  475. package/ext/permissionless.js/packages/wagmi/hooks/useWaitForTransactionReceipt.ts +427 -0
  476. package/ext/permissionless.js/packages/wagmi/index.ts +15 -0
  477. package/ext/permissionless.js/packages/wagmi/package.json +26 -0
  478. package/ext/permissionless.js/packages/wagmi/utils/observe.ts +76 -0
  479. package/ext/permissionless.js/packages/wagmi-demo/README.md +1 -0
  480. package/ext/permissionless.js/packages/wagmi-demo/biome.json +13 -0
  481. package/ext/permissionless.js/packages/wagmi-demo/index.html +12 -0
  482. package/ext/permissionless.js/packages/wagmi-demo/package.json +16 -0
  483. package/ext/permissionless.js/packages/wagmi-demo/src/App.tsx +98 -0
  484. package/ext/permissionless.js/packages/wagmi-demo/src/PasskeyServerDemo.tsx +286 -0
  485. package/ext/permissionless.js/packages/wagmi-demo/src/PasskeysDemo.tsx +457 -0
  486. package/ext/permissionless.js/packages/wagmi-demo/src/index.css +21 -0
  487. package/ext/permissionless.js/packages/wagmi-demo/src/main.tsx +275 -0
  488. package/ext/permissionless.js/packages/wagmi-demo/src/vite-env.d.ts +1 -0
  489. package/ext/permissionless.js/packages/wagmi-demo/src/wagmi.ts +33 -0
  490. package/ext/permissionless.js/packages/wagmi-demo/tsconfig.json +25 -0
  491. package/ext/permissionless.js/packages/wagmi-demo/tsconfig.node.json +12 -0
  492. package/ext/permissionless.js/packages/wagmi-demo/vite.config.ts +7 -0
  493. package/ext/permissionless.js/tsconfig/tsconfig.base.json +42 -0
  494. package/ext/permissionless.js/tsconfig/tsconfig.mock-paymaster.cjs.json +11 -0
  495. package/ext/permissionless.js/tsconfig/tsconfig.mock-paymaster.esm.json +9 -0
  496. package/ext/permissionless.js/tsconfig/tsconfig.mock-paymaster.json +17 -0
  497. package/ext/permissionless.js/tsconfig/tsconfig.mock-paymaster.types.json +13 -0
  498. package/ext/permissionless.js/tsconfig/tsconfig.permissionless.cjs.json +11 -0
  499. package/ext/permissionless.js/tsconfig/tsconfig.permissionless.esm.json +9 -0
  500. package/ext/permissionless.js/tsconfig/tsconfig.permissionless.json +18 -0
  501. package/ext/permissionless.js/tsconfig/tsconfig.permissionless.types.json +13 -0
  502. package/ext/permissionless.js/tsconfig/tsconfig.wagmi.esm.json +8 -0
  503. package/ext/permissionless.js/tsconfig/tsconfig.wagmi.json +19 -0
  504. package/ext/permissionless.js/tsconfig/tsconfig.wagmi.types.json +12 -0
  505. package/extract_abis.sh +140 -0
  506. package/extract_addresses_to_env.sh +67 -0
  507. package/final_safe_harmonize.py +77 -0
  508. package/lib/SHARED_CONFIG_REFERENCE.md +133 -0
  509. package/lib/shared-config/.env.example +6 -0
  510. package/lib/shared-config/.github/workflows/check-secrets.yml +257 -0
  511. package/lib/shared-config/AGENTS.md +21 -0
  512. package/lib/shared-config/CHANGELOG.md +99 -0
  513. package/lib/shared-config/LICENSE +21 -0
  514. package/lib/shared-config/QUICK_START.md +215 -0
  515. package/lib/shared-config/README.md +412 -0
  516. package/lib/shared-config/SHARED_CONFIG_SUMMARY.md +273 -0
  517. package/lib/shared-config/check-locker-status.mjs +7 -0
  518. package/lib/shared-config/favicon.ico +0 -0
  519. package/lib/shared-config/generate-comparison-table.sh +67 -0
  520. package/lib/shared-config/package.json +46 -0
  521. package/lib/shared-config/pnpm-lock.yaml +1182 -0
  522. package/lib/shared-config/src/abis/BLSAggregator.json +1 -0
  523. package/lib/shared-config/src/abis/DVTValidator.json +1 -0
  524. package/lib/shared-config/src/abis/GToken.json +1 -0
  525. package/lib/shared-config/src/abis/GTokenStaking.json +1 -0
  526. package/lib/shared-config/src/abis/MySBT.json +1 -0
  527. package/lib/shared-config/src/abis/PaymasterFactory.json +1 -0
  528. package/lib/shared-config/src/abis/PaymasterV4.json +1098 -0
  529. package/lib/shared-config/src/abis/Registry.json +1 -0
  530. package/lib/shared-config/src/abis/SimpleAccount.json +557 -0
  531. package/lib/shared-config/src/abis/SimpleAccountFactory.json +87 -0
  532. package/lib/shared-config/src/abis/SuperPaymasterV2.json +1 -0
  533. package/lib/shared-config/src/abis/index.ts +45 -0
  534. package/lib/shared-config/src/abis/xPNTsFactory.json +1 -0
  535. package/lib/shared-config/src/abis/xPNTsToken.json +1 -0
  536. package/lib/shared-config/src/branding.ts +32 -0
  537. package/lib/shared-config/src/communities.ts +93 -0
  538. package/lib/shared-config/src/constants.ts +67 -0
  539. package/lib/shared-config/src/contract-addresses.ts +95 -0
  540. package/lib/shared-config/src/contract-versions.ts +374 -0
  541. package/lib/shared-config/src/contracts.ts +414 -0
  542. package/lib/shared-config/src/index.ts +14 -0
  543. package/lib/shared-config/src/networks.ts +117 -0
  544. package/lib/shared-config/sync-abis.sh +92 -0
  545. package/lib/shared-config/sync-versions.mjs +150 -0
  546. package/lib/shared-config/tsconfig.json +18 -0
  547. package/lib/shared-config/tsup.config.ts +10 -0
  548. package/lib/shared-config/verify-all.sh +207 -0
  549. package/lib/shared-config/verify-contracts.sh +85 -0
  550. package/lib/shared-config/verify-mysbt-v243.mjs +27 -0
  551. package/lib/shared-config/verify-onchain-versions.mjs +93 -0
  552. package/package.json +53 -21
  553. package/packages/account/package.json +20 -0
  554. package/packages/account/src/accounts/simple.ts +84 -0
  555. package/packages/account/src/eoa.ts +31 -0
  556. package/packages/account/src/index.ts +61 -0
  557. package/packages/account/tsconfig.json +12 -0
  558. package/packages/analytics/package.json +21 -0
  559. package/packages/analytics/src/index.ts +145 -0
  560. package/packages/analytics/tsconfig.json +16 -0
  561. package/packages/community/package.json +22 -0
  562. package/packages/community/src/index.ts +306 -0
  563. package/packages/community/tsconfig.json +8 -0
  564. package/packages/core/package.json +22 -0
  565. package/packages/core/src/abis/BLSAggregator.json +572 -0
  566. package/packages/core/src/abis/BLSValidator.json +26 -0
  567. package/packages/core/src/abis/DVTValidator.json +370 -0
  568. package/packages/core/src/abis/Eip7702Support.json +24 -0
  569. package/packages/core/src/abis/EntryPoint.json +1379 -0
  570. package/packages/core/src/abis/GToken.json +523 -0
  571. package/packages/core/src/abis/GTokenStaking.json +931 -0
  572. package/packages/core/src/abis/LegacyAccount.json +625 -0
  573. package/packages/core/src/abis/MySBT.json +1586 -0
  574. package/packages/core/src/abis/Paymaster.json +1205 -0
  575. package/packages/core/src/abis/PaymasterFactory.json +650 -0
  576. package/packages/core/src/abis/PaymasterV4_2.json +1183 -0
  577. package/packages/core/src/abis/Registry.json +1636 -0
  578. package/packages/core/src/abis/ReputationSystem.json +477 -0
  579. package/packages/core/src/abis/SenderCreator.json +99 -0
  580. package/packages/core/src/abis/Simple7702Account.json +395 -0
  581. package/packages/core/src/abis/SimpleAccount.json +625 -0
  582. package/packages/core/src/abis/SimpleAccountFactory.json +108 -0
  583. package/packages/core/src/abis/SimpleAccountFactoryV08.json +87 -0
  584. package/packages/core/src/abis/SimpleAccountV08.json +557 -0
  585. package/packages/core/src/abis/SuperPaymaster.json +1399 -0
  586. package/packages/core/src/abis/UserOperationLib.json +57 -0
  587. package/packages/core/src/abis/aPNTs.json +1173 -0
  588. package/packages/core/src/abis/index.ts +68 -0
  589. package/packages/core/src/abis/xPNTsFactory.json +728 -0
  590. package/packages/core/src/abis/xPNTsToken.json +1173 -0
  591. package/packages/core/src/actions/aggregator.ts +41 -0
  592. package/packages/core/src/actions/dvt.ts +53 -0
  593. package/packages/core/src/actions/factory.ts +41 -0
  594. package/packages/core/src/actions/index.ts +10 -0
  595. package/packages/core/src/actions/paymasterV4.ts +263 -0
  596. package/packages/core/src/actions/registry.ts +120 -0
  597. package/packages/core/src/actions/reputation.ts +27 -0
  598. package/packages/core/src/actions/sbt.ts +97 -0
  599. package/packages/core/src/actions/staking.ts +79 -0
  600. package/packages/core/src/actions/superPaymaster.ts +117 -0
  601. package/packages/core/src/actions/tokens.ts +65 -0
  602. package/packages/core/src/branding.ts +32 -0
  603. package/packages/core/src/clients.ts +13 -0
  604. package/packages/core/src/communities.ts +93 -0
  605. package/packages/core/src/constants.ts +81 -0
  606. package/packages/core/src/contract-addresses.ts +101 -0
  607. package/packages/core/src/contract-versions.ts +374 -0
  608. package/packages/core/src/contracts.ts +414 -0
  609. package/packages/core/src/crypto/blsSigner.ts +124 -0
  610. package/packages/core/src/crypto/index.ts +1 -0
  611. package/packages/core/src/index.ts +19 -0
  612. package/packages/core/src/networks.ts +127 -0
  613. package/packages/core/src/requirementChecker.ts +225 -0
  614. package/packages/core/src/roles.ts +244 -0
  615. package/packages/core/src/utils.ts +23 -0
  616. package/packages/core/tsconfig.json +12 -0
  617. package/packages/dapp/package.json +27 -0
  618. package/packages/dapp/src/index.ts +4 -0
  619. package/packages/dapp/src/ui/components/EvaluationPanel.tsx +40 -0
  620. package/packages/dapp/src/ui/hooks/useCreditScore.ts +44 -0
  621. package/packages/dapp/src/ui/hooks/useSuperPaymaster.ts +31 -0
  622. package/packages/dapp/src/ui/index.ts +22 -0
  623. package/packages/dapp/tsconfig.json +13 -0
  624. package/packages/enduser/package.json +21 -0
  625. package/packages/enduser/src/index.ts +138 -0
  626. package/packages/enduser/tsconfig.json +8 -0
  627. package/packages/identity/package.json +22 -0
  628. package/packages/identity/src/index.ts +82 -0
  629. package/packages/identity/src/mysbt.ts +48 -0
  630. package/packages/identity/tsconfig.json +12 -0
  631. package/packages/operator/package.json +21 -0
  632. package/packages/operator/src/index.ts +172 -0
  633. package/packages/operator/tsconfig.json +8 -0
  634. package/packages/paymaster/package.json +22 -0
  635. package/packages/paymaster/src/SuperPaymaster/index.ts +168 -0
  636. package/packages/paymaster/src/V4/index.ts +123 -0
  637. package/packages/paymaster/src/index.ts +5 -0
  638. package/packages/paymaster/tsconfig.json +12 -0
  639. package/packages/sdk/README.md +150 -0
  640. package/packages/sdk/aastar/package.json +21 -0
  641. package/packages/sdk/aastar/src/index.ts +3 -0
  642. package/packages/sdk/aastar/tsconfig.json +8 -0
  643. package/packages/sdk/examples/config.json +1 -0
  644. package/packages/sdk/examples/regression_test.ts +106 -0
  645. package/packages/sdk/package.json +32 -0
  646. package/packages/sdk/src/clients/admin.ts +54 -0
  647. package/packages/sdk/src/clients/community.ts +403 -0
  648. package/packages/sdk/src/clients/endUser.ts +173 -0
  649. package/packages/sdk/src/clients/operator.ts +277 -0
  650. package/packages/sdk/src/errors/decoder.ts +48 -0
  651. package/{dist/index.js → packages/sdk/src/index.ts} +9 -1
  652. package/packages/sdk/src/utils/errorHandler.ts +167 -0
  653. package/packages/sdk/src/utils/funding.ts +280 -0
  654. package/packages/sdk/src/utils/keys.ts +159 -0
  655. package/packages/sdk/src/utils/roleData.ts +151 -0
  656. package/packages/sdk/src/utils/validation.ts +356 -0
  657. package/packages/sdk/tsconfig.json +12 -0
  658. package/packages/tokens/package.json +22 -0
  659. package/packages/tokens/src/index.ts +245 -0
  660. package/packages/tokens/tsconfig.json +12 -0
  661. package/pnpm-workspace.yaml +2 -0
  662. package/run_full_regression.sh +215 -0
  663. package/run_sdk_regression.sh +213 -0
  664. package/safe_harmonize.py +107 -0
  665. package/scripts/00_utils.ts +59 -0
  666. package/scripts/00_verify_phase1.ts +130 -0
  667. package/scripts/01_1_prep_gtoken.ts +81 -0
  668. package/scripts/01_2_register_sbt.ts +88 -0
  669. package/scripts/01_3_prep_tokens_paymaster.ts +102 -0
  670. package/scripts/01_prepare_all.ts +271 -0
  671. package/scripts/02_test_eoa.ts +50 -0
  672. package/scripts/03_test_standard_aa.ts +173 -0
  673. package/scripts/04_0_check_deploy.ts +24 -0
  674. package/scripts/04_1_check_allowance.ts +44 -0
  675. package/scripts/04_2_construct_verify.ts +96 -0
  676. package/scripts/04_3_verify_estimate.ts +66 -0
  677. package/scripts/04_4_verify_pack.ts +74 -0
  678. package/scripts/04_test_paymaster_v4.ts +217 -0
  679. package/scripts/05_1_deposit.ts +48 -0
  680. package/scripts/05_test_superpaymaster.ts +380 -0
  681. package/scripts/06_local_test_v3_admin.ts +163 -0
  682. package/scripts/06_local_test_v3_execution.ts +132 -0
  683. package/scripts/06_local_test_v3_full.ts +490 -0
  684. package/scripts/06_local_test_v3_funding.ts +124 -0
  685. package/scripts/06_local_test_v3_reputation.ts +234 -0
  686. package/scripts/07_local_test_v3_audit.ts +181 -0
  687. package/scripts/08_local_test_registry_lifecycle.ts +382 -0
  688. package/scripts/09_local_test_community_lifecycle.ts +384 -0
  689. package/scripts/09_local_test_community_simple.ts +108 -0
  690. package/scripts/09_scenario_bread_independent.ts +247 -0
  691. package/scripts/10_scenario_super_shared.ts +196 -0
  692. package/scripts/10_test_protocol_admin_full.ts +173 -0
  693. package/scripts/11_scenario_hacker_defense.ts +104 -0
  694. package/scripts/11_test_core_flows_full.ts +279 -0
  695. package/scripts/12_test_slash_mechanism.ts +205 -0
  696. package/scripts/12_test_slash_queries.ts +83 -0
  697. package/scripts/12_test_staking_exit.ts +152 -0
  698. package/scripts/12_test_staking_slash.ts +301 -0
  699. package/scripts/12_test_tier2_slash.ts +139 -0
  700. package/scripts/13_test_sbt_burn_linkage.ts +266 -0
  701. package/scripts/14_test_credit_redesign.ts +266 -0
  702. package/scripts/15_test_bls_full.ts +125 -0
  703. package/scripts/15_test_dvt_bls_full.ts +133 -0
  704. package/scripts/17_test_cross_role_collaboration.ts +95 -0
  705. package/scripts/18_sdk_e2e_verification.ts +67 -0
  706. package/scripts/18_test_dvt_sdk_flow.ts +138 -0
  707. package/scripts/18_test_lifecycle_completion.ts +144 -0
  708. package/scripts/19_sdk_experiment_runner.ts +89 -0
  709. package/scripts/19_sdk_experiment_runner.ts.backup +391 -0
  710. package/scripts/20_sdk_full_capability.ts +95 -0
  711. package/scripts/20_test_superpaymaster_new_apis.ts +193 -0
  712. package/scripts/21_test_paymasterv4_complete.ts +341 -0
  713. package/scripts/22_test_bls_signing.ts +260 -0
  714. package/scripts/23_test_middleware.ts +197 -0
  715. package/scripts/98_edge_reentrancy.ts +85 -0
  716. package/scripts/99_bug_hunting_fast.ts +216 -0
  717. package/scripts/collect_industry_baseline.ts +236 -0
  718. package/scripts/complete_env_config.ts +97 -0
  719. package/scripts/debug_account_c.ts +43 -0
  720. package/scripts/debug_bls.ts +58 -0
  721. package/scripts/debug_config_v036.ts +13 -0
  722. package/scripts/debug_contracts.ts +2 -0
  723. package/scripts/debug_env.ts +69 -0
  724. package/scripts/debug_find_paymaster.ts +98 -0
  725. package/scripts/debug_isolated_registration.ts +256 -0
  726. package/scripts/debug_paymaster_config.ts +19 -0
  727. package/scripts/debug_pim_addr.ts +23 -0
  728. package/scripts/debug_pm_status.ts +51 -0
  729. package/scripts/debug_registry.ts +39 -0
  730. package/scripts/debug_registry_setup.ts +129 -0
  731. package/scripts/debug_sanity.ts +32 -0
  732. package/scripts/debug_shared_config.ts +10 -0
  733. package/scripts/debug_token_compat.ts +51 -0
  734. package/scripts/debug_tokens.ts +41 -0
  735. package/scripts/debug_vcheck.ts +33 -0
  736. package/scripts/deploy_and_init_v3.sh +134 -0
  737. package/scripts/deploy_anvil_accounts.ts +144 -0
  738. package/scripts/deploy_paymaster_v4.ts +139 -0
  739. package/scripts/deploy_test_accounts.ts +401 -0
  740. package/scripts/experiment/stage3/SETUP_GUIDE.md +258 -0
  741. package/scripts/experiment/stage3/archived_scripts/00_token_distribution.ts +78 -0
  742. package/scripts/experiment/stage3/archived_scripts/01_dao_launch.ts +96 -0
  743. package/scripts/experiment/stage3/archived_scripts/01b_bread_launch.ts +112 -0
  744. package/scripts/experiment/stage3/archived_scripts/02_operator_setup.ts +84 -0
  745. package/scripts/experiment/stage3/archived_scripts/02b_operator_b_setup.ts +104 -0
  746. package/scripts/experiment/stage3/archived_scripts/02c_finalize_operators.ts +86 -0
  747. package/scripts/experiment/stage3/archived_scripts/02d_operator_collateral.ts +89 -0
  748. package/scripts/experiment/stage3/archived_scripts/03_user_onboarding.ts +83 -0
  749. package/scripts/experiment/stage3/archived_scripts/03b_deploy_aa_account.ts +61 -0
  750. package/scripts/experiment/stage3/archived_scripts/03c_aa_onboarding.ts +104 -0
  751. package/scripts/experiment/stage3/archived_scripts/03d_mint_points.ts +60 -0
  752. package/scripts/experiment/stage3/archived_scripts/04_benchmarking.ts +100 -0
  753. package/scripts/experiment/stage3/archived_scripts/05_multi_op_setup.ts +149 -0
  754. package/scripts/experiment/stage3/archived_scripts/README.md +58 -0
  755. package/scripts/experiment/stage3/archived_scripts/check_roles.ts +29 -0
  756. package/scripts/experiment/stage3/archived_scripts/decode_error.ts +23 -0
  757. package/scripts/experiment/stage3/archived_scripts/fund_user.ts +51 -0
  758. package/scripts/experiment/stage3/archived_scripts/gen_b_key.ts +3 -0
  759. package/scripts/experiment/stage3/archived_scripts/gen_keys.ts +4 -0
  760. package/scripts/experiment/stage3/archived_scripts/setup.ts +105 -0
  761. package/scripts/experiment/stage3/archived_scripts/test_key.ts +4 -0
  762. package/scripts/experiment/stage3/archived_scripts/verify_state.ts +59 -0
  763. package/scripts/experiment/stage3/refactored/00_token_distribution.ts +46 -0
  764. package/scripts/experiment/stage3/refactored/02_operator_setup.ts +65 -0
  765. package/scripts/experiment/stage3/refactored/03_user_onboarding.ts +68 -0
  766. package/scripts/experiment/stage3/refactored/05_multi_op_setup.ts +63 -0
  767. package/scripts/experiment/stage3/refactored/README.md +71 -0
  768. package/scripts/extract-docs.sh +72 -0
  769. package/scripts/generate_env_from_deployment.ts +109 -0
  770. package/scripts/publish_all.sh +39 -0
  771. package/scripts/quick_setup.ts +124 -0
  772. package/scripts/run_automated_experiment.sh +121 -0
  773. package/scripts/run_daily_experiment.ts +70 -0
  774. package/scripts/security_audit.sh +172 -0
  775. package/scripts/sync_config_to_env.ts +88 -0
  776. package/scripts/test_groups.ts +267 -0
  777. package/scripts/test_multi_community_anvil.ts +276 -0
  778. package/scripts/test_new_sdk_apis_sepolia.ts +115 -0
  779. package/scripts/test_sdk_join_idempotent.ts +233 -0
  780. package/scripts/test_simple_sepolia.ts +44 -0
  781. package/scripts/v2_regression/00_validate_env.ts +77 -0
  782. package/scripts/v2_regression/01_setup_and_fund.ts +132 -0
  783. package/scripts/v2_regression/02_operator_onboarding.ts +300 -0
  784. package/scripts/v2_regression/03_community_registry.ts +173 -0
  785. package/scripts/v2_regression/04_enduser_flow.ts +174 -0
  786. package/scripts/v2_regression/05_admin_audit.ts +157 -0
  787. package/scripts/v2_regression/README.md +161 -0
  788. package/scripts/validate_env.ts +112 -0
  789. package/scripts/validate_environment.ts +140 -0
  790. package/sdk_experiment_data.csv +2 -0
  791. package/surgical_harmonize.py +83 -0
  792. package/tsconfig.json +15 -0
  793. package/typedoc.json +25 -0
  794. package/dist/clients/admin.d.ts +0 -12
  795. package/dist/clients/admin.d.ts.map +0 -1
  796. package/dist/clients/admin.js +0 -20
  797. package/dist/clients/admin.js.map +0 -1
  798. package/dist/clients/community.d.ts +0 -12
  799. package/dist/clients/community.d.ts.map +0 -1
  800. package/dist/clients/community.js +0 -18
  801. package/dist/clients/community.js.map +0 -1
  802. package/dist/clients/endUser.d.ts +0 -12
  803. package/dist/clients/endUser.d.ts.map +0 -1
  804. package/dist/clients/endUser.js +0 -20
  805. package/dist/clients/endUser.js.map +0 -1
  806. package/dist/clients/operator.d.ts +0 -18
  807. package/dist/clients/operator.d.ts.map +0 -1
  808. package/dist/clients/operator.js +0 -65
  809. package/dist/clients/operator.js.map +0 -1
  810. package/dist/index.d.ts +0 -11
  811. package/dist/index.d.ts.map +0 -1
  812. package/dist/index.js.map +0 -1
@@ -0,0 +1,496 @@
1
+ import {
2
+ type Account,
3
+ type Address,
4
+ type Assign,
5
+ type Chain,
6
+ type Client,
7
+ type Hex,
8
+ type JsonRpcAccount,
9
+ type LocalAccount,
10
+ type OneOf,
11
+ type Transport,
12
+ type WalletClient,
13
+ concat,
14
+ decodeFunctionData,
15
+ encodeFunctionData,
16
+ hashMessage,
17
+ hashTypedData
18
+ } from "viem"
19
+ import {
20
+ type SmartAccount,
21
+ type SmartAccountImplementation,
22
+ type UserOperation,
23
+ entryPoint06Abi,
24
+ entryPoint07Abi,
25
+ entryPoint07Address,
26
+ getUserOperationHash,
27
+ toSmartAccount
28
+ } from "viem/account-abstraction"
29
+ import { getChainId, signMessage } from "viem/actions"
30
+ import { getAction } from "viem/utils"
31
+ import { getAccountNonce } from "../../actions/public/getAccountNonce.js"
32
+ import { getSenderAddress } from "../../actions/public/getSenderAddress.js"
33
+ import { type EthereumProvider, toOwner } from "../../utils/toOwner.js"
34
+
35
+ const getAccountInitCode = async (
36
+ owner: Address,
37
+ index = BigInt(0)
38
+ ): Promise<Hex> => {
39
+ if (!owner) throw new Error("Owner account not found")
40
+
41
+ return encodeFunctionData({
42
+ abi: [
43
+ {
44
+ inputs: [
45
+ {
46
+ internalType: "address",
47
+ name: "owner",
48
+ type: "address"
49
+ },
50
+ {
51
+ internalType: "uint256",
52
+ name: "salt",
53
+ type: "uint256"
54
+ }
55
+ ],
56
+ name: "createAccount",
57
+ outputs: [
58
+ {
59
+ internalType: "contract LightAccount",
60
+ name: "ret",
61
+ type: "address"
62
+ }
63
+ ],
64
+ stateMutability: "nonpayable",
65
+ type: "function"
66
+ }
67
+ ],
68
+ functionName: "createAccount",
69
+ args: [owner, index]
70
+ })
71
+ }
72
+
73
+ export type LightAccountVersion<entryPointVersion extends "0.6" | "0.7"> =
74
+ entryPointVersion extends "0.6" ? "1.1.0" : "2.0.0"
75
+
76
+ export type ToLightSmartAccountParameters<
77
+ entryPointVersion extends "0.6" | "0.7" = "0.7"
78
+ > = {
79
+ client: Client<
80
+ Transport,
81
+ Chain | undefined,
82
+ JsonRpcAccount | LocalAccount | undefined
83
+ >
84
+ entryPoint?: {
85
+ address: Address
86
+ version: entryPointVersion
87
+ }
88
+ owner: OneOf<
89
+ | EthereumProvider
90
+ | WalletClient<Transport, Chain | undefined, Account>
91
+ | LocalAccount
92
+ >
93
+ version: LightAccountVersion<entryPointVersion>
94
+ factoryAddress?: Address
95
+ index?: bigint
96
+ address?: Address
97
+ nonceKey?: bigint
98
+ }
99
+
100
+ async function signWith1271WrapperV1(
101
+ signer: LocalAccount,
102
+ chainId: number,
103
+ accountAddress: Address,
104
+ hashedMessage: Hex
105
+ ): Promise<Hex> {
106
+ return signer.signTypedData({
107
+ domain: {
108
+ chainId: Number(chainId),
109
+ name: "LightAccount",
110
+ verifyingContract: accountAddress,
111
+ version: "1"
112
+ },
113
+ types: {
114
+ LightAccountMessage: [{ name: "message", type: "bytes" }]
115
+ },
116
+ message: {
117
+ message: hashedMessage
118
+ },
119
+ primaryType: "LightAccountMessage"
120
+ })
121
+ }
122
+
123
+ const LIGHT_VERSION_TO_ADDRESSES_MAP: {
124
+ [key in LightAccountVersion<"0.6" | "0.7">]: {
125
+ factoryAddress: Address
126
+ }
127
+ } = {
128
+ "1.1.0": {
129
+ factoryAddress: "0x00004EC70002a32400f8ae005A26081065620D20"
130
+ },
131
+ "2.0.0": {
132
+ factoryAddress: "0x0000000000400CdFef5E2714E63d8040b700BC24"
133
+ }
134
+ }
135
+
136
+ const getDefaultAddresses = (
137
+ lightAccountVersion: LightAccountVersion<"0.6" | "0.7">,
138
+ {
139
+ factoryAddress: _factoryAddress
140
+ }: {
141
+ factoryAddress?: Address
142
+ }
143
+ ) => {
144
+ const factoryAddress =
145
+ _factoryAddress ??
146
+ LIGHT_VERSION_TO_ADDRESSES_MAP[lightAccountVersion].factoryAddress
147
+
148
+ return {
149
+ factoryAddress
150
+ }
151
+ }
152
+
153
+ export type LightSmartAccountImplementation<
154
+ entryPointVersion extends "0.6" | "0.7"
155
+ > = Assign<
156
+ SmartAccountImplementation<
157
+ entryPointVersion extends "0.6"
158
+ ? typeof entryPoint06Abi
159
+ : typeof entryPoint07Abi,
160
+ entryPointVersion
161
+ >,
162
+ { sign: NonNullable<SmartAccountImplementation["sign"]> }
163
+ >
164
+
165
+ export type ToLightSmartAccountReturnType<
166
+ entryPointVersion extends "0.6" | "0.7" = "0.7"
167
+ > = SmartAccount<LightSmartAccountImplementation<entryPointVersion>>
168
+
169
+ enum SignatureType {
170
+ EOA = "0x00"
171
+ // CONTRACT = "0x01",
172
+ // CONTRACT_WITH_ADDR = "0x02"
173
+ }
174
+
175
+ /**
176
+ * @description Creates an Light Account from a private key.
177
+ *
178
+ * @returns A Private Key Light Account.
179
+ */
180
+ export async function toLightSmartAccount<
181
+ entryPointVersion extends "0.6" | "0.7" = "0.7"
182
+ >(
183
+ parameters: ToLightSmartAccountParameters<entryPointVersion>
184
+ ): Promise<ToLightSmartAccountReturnType<entryPointVersion>> {
185
+ const {
186
+ version,
187
+ factoryAddress: _factoryAddress,
188
+ address,
189
+ owner,
190
+ client,
191
+ index = BigInt(0),
192
+ nonceKey
193
+ } = parameters
194
+
195
+ const localOwner = await toOwner({ owner })
196
+
197
+ const entryPoint = {
198
+ address: parameters.entryPoint?.address ?? entryPoint07Address,
199
+ abi:
200
+ (parameters.entryPoint?.version ?? "0.7") === "0.6"
201
+ ? entryPoint06Abi
202
+ : entryPoint07Abi,
203
+ version: parameters.entryPoint?.version ?? "0.7"
204
+ } as const
205
+
206
+ const { factoryAddress } = getDefaultAddresses(version, {
207
+ factoryAddress: _factoryAddress
208
+ })
209
+
210
+ let accountAddress: Address | undefined = address
211
+
212
+ let chainId: number
213
+
214
+ const getMemoizedChainId = async () => {
215
+ if (chainId) return chainId
216
+ chainId = client.chain
217
+ ? client.chain.id
218
+ : await getAction(client, getChainId, "getChainId")({})
219
+ return chainId
220
+ }
221
+
222
+ const getFactoryArgs = async () => {
223
+ return {
224
+ factory: factoryAddress,
225
+ factoryData: await getAccountInitCode(localOwner.address, index)
226
+ }
227
+ }
228
+
229
+ return toSmartAccount({
230
+ client,
231
+ entryPoint,
232
+ getFactoryArgs,
233
+ async getAddress() {
234
+ if (accountAddress) return accountAddress
235
+
236
+ const { factory, factoryData } = await getFactoryArgs()
237
+
238
+ accountAddress = await getSenderAddress(client, {
239
+ factory,
240
+ factoryData,
241
+ entryPointAddress: entryPoint.address
242
+ })
243
+
244
+ return accountAddress
245
+ },
246
+ async encodeCalls(calls) {
247
+ if (calls.length > 1) {
248
+ return encodeFunctionData({
249
+ abi: [
250
+ {
251
+ inputs: [
252
+ {
253
+ internalType: "address[]",
254
+ name: "dest",
255
+ type: "address[]"
256
+ },
257
+ {
258
+ internalType: "uint256[]",
259
+ name: "value",
260
+ type: "uint256[]"
261
+ },
262
+ {
263
+ internalType: "bytes[]",
264
+ name: "func",
265
+ type: "bytes[]"
266
+ }
267
+ ],
268
+ name: "executeBatch",
269
+ outputs: [],
270
+ stateMutability: "nonpayable",
271
+ type: "function"
272
+ }
273
+ ],
274
+ functionName: "executeBatch",
275
+ args: [
276
+ calls.map((a) => a.to),
277
+ calls.map((a) => a.value ?? 0n),
278
+ calls.map((a) => a.data ?? "0x")
279
+ ]
280
+ })
281
+ }
282
+
283
+ const call = calls.length === 0 ? undefined : calls[0]
284
+
285
+ if (!call) {
286
+ throw new Error("No calls to encode")
287
+ }
288
+
289
+ return encodeFunctionData({
290
+ abi: [
291
+ {
292
+ inputs: [
293
+ {
294
+ internalType: "address",
295
+ name: "dest",
296
+ type: "address"
297
+ },
298
+ {
299
+ internalType: "uint256",
300
+ name: "value",
301
+ type: "uint256"
302
+ },
303
+ {
304
+ internalType: "bytes",
305
+ name: "func",
306
+ type: "bytes"
307
+ }
308
+ ],
309
+ name: "execute",
310
+ outputs: [],
311
+ stateMutability: "nonpayable",
312
+ type: "function"
313
+ }
314
+ ],
315
+ functionName: "execute",
316
+ args: [call.to, call.value ?? 0n, call.data ?? "0x"]
317
+ })
318
+ },
319
+ async decodeCalls(callData) {
320
+ try {
321
+ const decoded = decodeFunctionData({
322
+ abi: [
323
+ {
324
+ inputs: [
325
+ {
326
+ internalType: "address[]",
327
+ name: "dest",
328
+ type: "address[]"
329
+ },
330
+ {
331
+ internalType: "uint256[]",
332
+ name: "value",
333
+ type: "uint256[]"
334
+ },
335
+ {
336
+ internalType: "bytes[]",
337
+ name: "func",
338
+ type: "bytes[]"
339
+ }
340
+ ],
341
+ name: "executeBatch",
342
+ outputs: [],
343
+ stateMutability: "nonpayable",
344
+ type: "function"
345
+ }
346
+ ],
347
+ data: callData
348
+ })
349
+
350
+ if (decoded.functionName === "executeBatch") {
351
+ const calls: {
352
+ to: Address
353
+ value: bigint
354
+ data: Hex
355
+ }[] = []
356
+
357
+ for (let i = 0; i < decoded.args[0].length; i++) {
358
+ calls.push({
359
+ to: decoded.args[0][i],
360
+ value: decoded.args[1][i],
361
+ data: decoded.args[2][i]
362
+ })
363
+ }
364
+
365
+ return calls
366
+ }
367
+
368
+ throw new Error("Invalid function name")
369
+ } catch {
370
+ const decoded = decodeFunctionData({
371
+ abi: [
372
+ {
373
+ inputs: [
374
+ {
375
+ internalType: "address",
376
+ name: "dest",
377
+ type: "address"
378
+ },
379
+ {
380
+ internalType: "uint256",
381
+ name: "value",
382
+ type: "uint256"
383
+ },
384
+ {
385
+ internalType: "bytes",
386
+ name: "func",
387
+ type: "bytes"
388
+ }
389
+ ],
390
+ name: "execute",
391
+ outputs: [],
392
+ stateMutability: "nonpayable",
393
+ type: "function"
394
+ }
395
+ ],
396
+ data: callData
397
+ })
398
+
399
+ return [
400
+ {
401
+ to: decoded.args[0],
402
+ value: decoded.args[1],
403
+ data: decoded.args[2]
404
+ }
405
+ ]
406
+ }
407
+ },
408
+ async getNonce(args) {
409
+ return getAccountNonce(client, {
410
+ address: await this.getAddress(),
411
+ entryPointAddress: entryPoint.address,
412
+ key: nonceKey ?? args?.key
413
+ })
414
+ },
415
+ async getStubSignature() {
416
+ const signature =
417
+ "0xfffffffffffffffffffffffffffffff0000000000000000000000000000000007aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa1c"
418
+
419
+ switch (version) {
420
+ case "1.1.0":
421
+ return signature
422
+ case "2.0.0":
423
+ return concat([SignatureType.EOA, signature])
424
+ default:
425
+ throw new Error("Unknown Light Account version")
426
+ }
427
+ },
428
+ async sign({ hash }) {
429
+ return this.signMessage({ message: hash })
430
+ },
431
+ async signMessage({ message }) {
432
+ const signature = await signWith1271WrapperV1(
433
+ localOwner,
434
+ await getMemoizedChainId(),
435
+ await this.getAddress(),
436
+ hashMessage(message)
437
+ )
438
+
439
+ switch (version) {
440
+ case "1.1.0":
441
+ return signature
442
+ case "2.0.0":
443
+ return concat([SignatureType.EOA, signature])
444
+ default:
445
+ throw new Error("Unknown Light Account version")
446
+ }
447
+ },
448
+ async signTypedData(typedData) {
449
+ const signature = await signWith1271WrapperV1(
450
+ localOwner,
451
+ await getMemoizedChainId(),
452
+ await this.getAddress(),
453
+ hashTypedData(typedData)
454
+ )
455
+
456
+ switch (version) {
457
+ case "1.1.0":
458
+ return signature
459
+ case "2.0.0":
460
+ return concat([SignatureType.EOA, signature])
461
+ default:
462
+ throw new Error("Unknown Light Account version")
463
+ }
464
+ },
465
+ async signUserOperation(parameters) {
466
+ const { chainId = await getMemoizedChainId(), ...userOperation } =
467
+ parameters
468
+
469
+ const hash = getUserOperationHash({
470
+ userOperation: {
471
+ ...userOperation,
472
+ signature: "0x"
473
+ } as UserOperation<entryPointVersion>,
474
+ entryPointAddress: entryPoint.address,
475
+ entryPointVersion: entryPoint.version,
476
+ chainId: chainId
477
+ })
478
+
479
+ const signature = await signMessage(client, {
480
+ account: localOwner,
481
+ message: {
482
+ raw: hash
483
+ }
484
+ })
485
+
486
+ switch (version) {
487
+ case "1.1.0":
488
+ return signature
489
+ case "2.0.0":
490
+ return concat([SignatureType.EOA, signature])
491
+ default:
492
+ throw new Error("Unknown Light Account version")
493
+ }
494
+ }
495
+ }) as Promise<ToLightSmartAccountReturnType<entryPointVersion>>
496
+ }