@openzeppelin/contracts-mcp 0.5.9 → 0.6.0

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 (153) hide show
  1. package/README.md +20 -1
  2. package/apps/cairo-account.html +20 -0
  3. package/apps/cairo-custom.html +20 -0
  4. package/apps/cairo-erc1155.html +20 -0
  5. package/apps/cairo-erc20.html +20 -0
  6. package/apps/cairo-erc721.html +20 -0
  7. package/apps/cairo-governor.html +20 -0
  8. package/apps/cairo-multisig.html +20 -0
  9. package/apps/cairo-vesting.html +20 -0
  10. package/apps/confidential-erc7984.html +20 -0
  11. package/apps/solidity-account.html +22 -0
  12. package/apps/solidity-custom.html +22 -0
  13. package/apps/solidity-erc1155.html +22 -0
  14. package/apps/solidity-erc20.html +22 -0
  15. package/apps/solidity-erc721.html +22 -0
  16. package/apps/solidity-governor.html +22 -0
  17. package/apps/solidity-rwa.html +22 -0
  18. package/apps/solidity-stablecoin.html +22 -0
  19. package/apps/stellar-fungible.html +20 -0
  20. package/apps/stellar-governor.html +20 -0
  21. package/apps/stellar-non-fungible.html +20 -0
  22. package/apps/stellar-stablecoin.html +20 -0
  23. package/apps/stellar-vault.html +20 -0
  24. package/apps/stylus-erc1155.html +20 -0
  25. package/apps/stylus-erc20.html +20 -0
  26. package/apps/stylus-erc721.html +20 -0
  27. package/apps/uniswap-hooks.html +20 -0
  28. package/dist/apps/register.d.ts +50 -0
  29. package/dist/apps/register.d.ts.map +1 -0
  30. package/dist/apps/register.js +129 -0
  31. package/dist/apps/register.js.map +1 -0
  32. package/dist/cairo/tools/account.d.ts.map +1 -1
  33. package/dist/cairo/tools/account.js +7 -9
  34. package/dist/cairo/tools/account.js.map +1 -1
  35. package/dist/cairo/tools/custom.d.ts.map +1 -1
  36. package/dist/cairo/tools/custom.js +7 -9
  37. package/dist/cairo/tools/custom.js.map +1 -1
  38. package/dist/cairo/tools/erc1155.d.ts.map +1 -1
  39. package/dist/cairo/tools/erc1155.js +7 -9
  40. package/dist/cairo/tools/erc1155.js.map +1 -1
  41. package/dist/cairo/tools/erc20.d.ts.map +1 -1
  42. package/dist/cairo/tools/erc20.js +7 -9
  43. package/dist/cairo/tools/erc20.js.map +1 -1
  44. package/dist/cairo/tools/erc721.d.ts.map +1 -1
  45. package/dist/cairo/tools/erc721.js +7 -9
  46. package/dist/cairo/tools/erc721.js.map +1 -1
  47. package/dist/cairo/tools/governor.d.ts.map +1 -1
  48. package/dist/cairo/tools/governor.js +7 -9
  49. package/dist/cairo/tools/governor.js.map +1 -1
  50. package/dist/cairo/tools/multisig.d.ts.map +1 -1
  51. package/dist/cairo/tools/multisig.js +7 -9
  52. package/dist/cairo/tools/multisig.js.map +1 -1
  53. package/dist/cairo/tools/vesting.d.ts.map +1 -1
  54. package/dist/cairo/tools/vesting.js +7 -9
  55. package/dist/cairo/tools/vesting.js.map +1 -1
  56. package/dist/cli.js +0 -0
  57. package/dist/confidential/tools/erc7984.d.ts.map +1 -1
  58. package/dist/confidential/tools/erc7984.js +7 -9
  59. package/dist/confidential/tools/erc7984.js.map +1 -1
  60. package/dist/server.d.ts.map +1 -1
  61. package/dist/server.js +5 -0
  62. package/dist/server.js.map +1 -1
  63. package/dist/solidity/tools/account.d.ts.map +1 -1
  64. package/dist/solidity/tools/account.js +7 -9
  65. package/dist/solidity/tools/account.js.map +1 -1
  66. package/dist/solidity/tools/custom.d.ts.map +1 -1
  67. package/dist/solidity/tools/custom.js +7 -9
  68. package/dist/solidity/tools/custom.js.map +1 -1
  69. package/dist/solidity/tools/erc1155.d.ts.map +1 -1
  70. package/dist/solidity/tools/erc1155.js +9 -9
  71. package/dist/solidity/tools/erc1155.js.map +1 -1
  72. package/dist/solidity/tools/erc20.d.ts.map +1 -1
  73. package/dist/solidity/tools/erc20.js +7 -9
  74. package/dist/solidity/tools/erc20.js.map +1 -1
  75. package/dist/solidity/tools/erc721.d.ts.map +1 -1
  76. package/dist/solidity/tools/erc721.js +9 -9
  77. package/dist/solidity/tools/erc721.js.map +1 -1
  78. package/dist/solidity/tools/governor.d.ts.map +1 -1
  79. package/dist/solidity/tools/governor.js +8 -9
  80. package/dist/solidity/tools/governor.js.map +1 -1
  81. package/dist/solidity/tools/rwa.d.ts +2 -2
  82. package/dist/solidity/tools/rwa.d.ts.map +1 -1
  83. package/dist/solidity/tools/rwa.js +7 -9
  84. package/dist/solidity/tools/rwa.js.map +1 -1
  85. package/dist/solidity/tools/stablecoin.d.ts.map +1 -1
  86. package/dist/solidity/tools/stablecoin.js +7 -9
  87. package/dist/solidity/tools/stablecoin.js.map +1 -1
  88. package/dist/stellar/tools/fungible.d.ts.map +1 -1
  89. package/dist/stellar/tools/fungible.js +7 -9
  90. package/dist/stellar/tools/fungible.js.map +1 -1
  91. package/dist/stellar/tools/governor.d.ts.map +1 -1
  92. package/dist/stellar/tools/governor.js +7 -9
  93. package/dist/stellar/tools/governor.js.map +1 -1
  94. package/dist/stellar/tools/non-fungible.d.ts.map +1 -1
  95. package/dist/stellar/tools/non-fungible.js +7 -9
  96. package/dist/stellar/tools/non-fungible.js.map +1 -1
  97. package/dist/stellar/tools/stablecoin.d.ts.map +1 -1
  98. package/dist/stellar/tools/stablecoin.js +7 -9
  99. package/dist/stellar/tools/stablecoin.js.map +1 -1
  100. package/dist/stellar/tools/vault.d.ts +3 -0
  101. package/dist/stellar/tools/vault.d.ts.map +1 -0
  102. package/dist/stellar/tools/vault.js +28 -0
  103. package/dist/stellar/tools/vault.js.map +1 -0
  104. package/dist/stellar/tools.d.ts.map +1 -1
  105. package/dist/stellar/tools.js +2 -0
  106. package/dist/stellar/tools.js.map +1 -1
  107. package/dist/stylus/tools/erc1155.d.ts.map +1 -1
  108. package/dist/stylus/tools/erc1155.js +7 -9
  109. package/dist/stylus/tools/erc1155.js.map +1 -1
  110. package/dist/stylus/tools/erc20.d.ts.map +1 -1
  111. package/dist/stylus/tools/erc20.js +7 -9
  112. package/dist/stylus/tools/erc20.js.map +1 -1
  113. package/dist/stylus/tools/erc721.d.ts.map +1 -1
  114. package/dist/stylus/tools/erc721.js +7 -9
  115. package/dist/stylus/tools/erc721.js.map +1 -1
  116. package/dist/uniswap-hooks/tools/hooks.d.ts.map +1 -1
  117. package/dist/uniswap-hooks/tools/hooks.js +7 -9
  118. package/dist/uniswap-hooks/tools/hooks.js.map +1 -1
  119. package/dist/utils.d.ts +4 -15
  120. package/dist/utils.d.ts.map +1 -1
  121. package/dist/utils.js +15 -39
  122. package/dist/utils.js.map +1 -1
  123. package/package.json +7 -4
  124. package/src/apps/register.ts +152 -0
  125. package/src/cairo/tools/account.ts +10 -12
  126. package/src/cairo/tools/custom.ts +10 -12
  127. package/src/cairo/tools/erc1155.ts +10 -12
  128. package/src/cairo/tools/erc20.ts +10 -12
  129. package/src/cairo/tools/erc721.ts +10 -12
  130. package/src/cairo/tools/governor.ts +10 -12
  131. package/src/cairo/tools/multisig.ts +10 -12
  132. package/src/cairo/tools/vesting.ts +10 -12
  133. package/src/confidential/tools/erc7984.ts +11 -13
  134. package/src/server.ts +5 -0
  135. package/src/solidity/tools/account.ts +10 -12
  136. package/src/solidity/tools/custom.ts +10 -12
  137. package/src/solidity/tools/erc1155.ts +26 -13
  138. package/src/solidity/tools/erc20.ts +10 -12
  139. package/src/solidity/tools/erc721.ts +14 -12
  140. package/src/solidity/tools/governor.ts +12 -12
  141. package/src/solidity/tools/rwa.ts +12 -14
  142. package/src/solidity/tools/stablecoin.ts +10 -12
  143. package/src/stellar/tools/fungible.ts +10 -12
  144. package/src/stellar/tools/governor.ts +10 -12
  145. package/src/stellar/tools/non-fungible.ts +10 -12
  146. package/src/stellar/tools/stablecoin.ts +10 -12
  147. package/src/stellar/tools/vault.ts +32 -0
  148. package/src/stellar/tools.ts +2 -0
  149. package/src/stylus/tools/erc1155.ts +10 -12
  150. package/src/stylus/tools/erc20.ts +10 -12
  151. package/src/stylus/tools/erc721.ts +10 -12
  152. package/src/uniswap-hooks/tools/hooks.ts +10 -13
  153. package/src/utils.ts +15 -38
package/README.md CHANGED
@@ -18,10 +18,29 @@ Provides tools to generate smart contract source code for the following language
18
18
  | solidity | erc20, erc721, erc1155, stablecoin, rwa, account, governor, custom |
19
19
  | cairo | erc20, erc721, erc1155, account, multisig, governor, vesting, custom |
20
20
  | confidential | erc7984 |
21
- | stellar | fungible, stablecoin, non-fungible |
21
+ | stellar | fungible, stablecoin, non-fungible, governor, vault |
22
22
  | stylus | erc20, erc721, erc1155 |
23
23
  | uniswap-hooks | hooks (tool name is just `uniswap-hooks`) |
24
24
 
25
+ ### MCP Apps
26
+
27
+ Hosts that support the [MCP Apps](https://modelcontextprotocol.io/extensions/apps/overview) extension (for example Cursor and Claude) can render an interactive Wizard UI for each tool: the same options as the web Wizard for that contract kind, a live code preview, and a button to hand the current source back to the agent. Language and kind pickers are omitted because the tool name already selects them.
28
+
29
+ **Send Updates to Agent** checks host MCP Apps capabilities:
30
+ - `message` (e.g. Claude): sends a chat message that includes the full current source so the agent sees option changes. Also best-effort stages via `updateModelContext` when advertised (some hosts do not attach silent context to draft-injected messages, so the message itself must be self-contained).
31
+ - No `message` capability (e.g. Cursor today, including hosts that only advertise `updateModelContext`): the button is **Copy to Clipboard** (same idea as the web Wizard copy action).
32
+ - Outbound links (tooltip “Read more”, import hyperlinks in the preview) use the host `openLinks` capability via `openLink`. If the host does not advertise it, those links are hidden so nothing looks clickable that cannot open.
33
+
34
+ Clients without Apps support continue to work — tools still return source code as Markdown text. The server always returns tool text; hosts that do not implement MCP Apps simply ignore the UI metadata.
35
+
36
+ #### App HTML artifacts
37
+
38
+ Interactive App HTML is **not** committed to git. It is generated into `packages/mcp/apps/` and included in the published npm tarball.
39
+
40
+ - **Published package (`npm` / `npx`)**: Apps HTML is already in the package; no extra build step.
41
+ - **Local checkout** (Cursor/Claude pointed at `packages/mcp/dist/cli.js`, or a `file:` dependency): run `yarn --cwd packages/mcp build:apps` after cloning or changing MCP App UI sources. If HTML is missing, the server fails closed at startup with a message to run that command (npm consumers should reinstall or report a packaging bug).
42
+ - **CI / publish**: CI builds Apps before MCP tests; `prepublishOnly` builds Apps before npm publish.
43
+
25
44
 
26
45
  ## Installation
27
46