@ic-reactor/mcp 0.0.0-stage → 0.0.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.
- package/.github/ISSUE_TEMPLATE/bug_report.yml +108 -0
- package/.github/ISSUE_TEMPLATE/config.yml +8 -0
- package/.github/ISSUE_TEMPLATE/feature_request.yml +77 -0
- package/.github/actions/setup-rust-wasm/action.yml +25 -0
- package/.github/dependabot.yml +107 -0
- package/.github/workflows/auth-latest.yml +67 -0
- package/.github/workflows/b3pay-site.yml +49 -0
- package/.github/workflows/ci.yml +430 -0
- package/.github/workflows/codeql.yml +41 -0
- package/.github/workflows/dependency-review.yml +68 -0
- package/.github/workflows/docs-check.yml +98 -0
- package/.github/workflows/docs.yml +265 -0
- package/.github/workflows/e2e.yml +90 -0
- package/.github/workflows/examples-published.yml +97 -0
- package/.github/workflows/release.yml +326 -0
- package/.husky/pre-commit +12 -0
- package/.prettierignore +109 -0
- package/.prettierrc +6 -0
- package/AGENTS.md +103 -0
- package/CHANGELOG.md +3268 -0
- package/CLAUDE.md +93 -0
- package/CNAME +1 -0
- package/CODE_OF_CONDUCT.md +7 -0
- package/CONTRIBUTING.md +433 -0
- package/LICENSE +21 -0
- package/README.md +2 -2
- package/SECURITY.md +74 -0
- package/b3pay-module.json +194 -0
- package/docs/.remarkrc.json +10 -0
- package/docs/README.md +64 -0
- package/docs/astro.config.mjs +205 -0
- package/docs/favicon.svg +15 -0
- package/docs/package.json +39 -0
- package/docs/public/favicon.svg +15 -0
- package/docs/public/ic-reactor-social-card.png +0 -0
- package/docs/scripts/b3pay-static.mjs +22 -0
- package/docs/scripts/check-example-docs.mjs +214 -0
- package/docs/scripts/check-links.mjs +212 -0
- package/docs/scripts/fix-dist-links.js +125 -0
- package/docs/scripts/fix-frontmatter.js +71 -0
- package/docs/scripts/remove-redundant-h1.cjs +48 -0
- package/docs/scripts/rewrite-typedoc-links.js +110 -0
- package/docs/scripts/split-index.js +69 -0
- package/docs/src/assets/ic-reactor-hero-dark.svg +23 -0
- package/docs/src/assets/ic-reactor-hero-light.svg +23 -0
- package/docs/src/assets/ic-reactor-lockup-dark.svg +15 -0
- package/docs/src/assets/ic-reactor-lockup-light.svg +15 -0
- package/docs/src/assets/ic-reactor-mark-dark.svg +14 -0
- package/docs/src/assets/ic-reactor-mark-light.svg +14 -0
- package/docs/src/assets/layers/candid-core-layer-icon-dark.svg +4 -0
- package/docs/src/assets/layers/candid-core-layer-icon-light.svg +4 -0
- package/docs/src/assets/layers/candid-profile-layer-icon-dark.svg +4 -0
- package/docs/src/assets/layers/candid-profile-layer-icon-light.svg +4 -0
- package/docs/src/assets/layers/ic-reactor-layer-icon-dark.svg +4 -0
- package/docs/src/assets/layers/ic-reactor-layer-icon-light.svg +4 -0
- package/docs/src/components/LibraryCards.astro +172 -0
- package/docs/src/components/LibraryIcon.astro +28 -0
- package/docs/src/components/SiteTitle.astro +241 -0
- package/docs/src/content/docs/404.mdx +19 -0
- package/docs/src/content/docs/build/agent-tools.mdx +593 -0
- package/docs/src/content/docs/build/icrc1-wallet.mdx +619 -0
- package/docs/src/content/docs/build/ssr-per-user.mdx +552 -0
- package/docs/src/content/docs/examples/canister-studio.mdx +95 -0
- package/docs/src/content/docs/examples/icrc-ledger.mdx +45 -0
- package/docs/src/content/docs/examples/index.mdx +38 -0
- package/docs/src/content/docs/examples/next-ssr.mdx +73 -0
- package/docs/src/content/docs/examples/node-agent-tool.mdx +80 -0
- package/docs/src/content/docs/examples/vite-wallet.mdx +71 -0
- package/docs/src/content/docs/guides/auth.mdx +1181 -0
- package/docs/src/content/docs/guides/client.mdx +551 -0
- package/docs/src/content/docs/guides/deploy.mdx +180 -0
- package/docs/src/content/docs/guides/errors.mdx +475 -0
- package/docs/src/content/docs/guides/getting-started.mdx +620 -0
- package/docs/src/content/docs/guides/reads.mdx +586 -0
- package/docs/src/content/docs/guides/ssr.mdx +529 -0
- package/docs/src/content/docs/guides/testing.mdx +401 -0
- package/docs/src/content/docs/guides/values.mdx +261 -0
- package/docs/src/content/docs/guides/vite-plugin.mdx +690 -0
- package/docs/src/content/docs/guides/writes.mdx +572 -0
- package/docs/src/content/docs/ic-reactor/index.mdx +167 -0
- package/docs/src/content/docs/index.mdx +65 -0
- package/docs/src/content/docs/migrating-from-3.mdx +535 -0
- package/docs/src/content/docs/packages/core.mdx +186 -0
- package/docs/src/content/docs/packages/mcp.mdx +163 -0
- package/docs/src/content/docs/packages/react.mdx +207 -0
- package/docs/src/content/docs/packages/vite-plugin.mdx +73 -0
- package/docs/src/content/docs/versioning.mdx +104 -0
- package/docs/src/content.config.ts +7 -0
- package/docs/src/styles/custom.css +189 -0
- package/docs/tsconfig.typedoc.json +26 -0
- package/docs/typedoc-entry.ts +17 -0
- package/docs/typedoc.json +37 -0
- package/e2e/Cargo.lock +646 -0
- package/e2e/Cargo.toml +3 -0
- package/e2e/README.md +101 -0
- package/e2e/frontends/build.mjs +94 -0
- package/e2e/frontends/index.html +10 -0
- package/e2e/global-setup.ts +65 -0
- package/e2e/icp.yaml +38 -0
- package/e2e/package.json +40 -0
- package/e2e/setup.ts +6 -0
- package/e2e/src/actor/Cargo.toml +14 -0
- package/e2e/src/actor/hello_actor.did +10 -0
- package/e2e/src/actor/src/lib.rs +73 -0
- package/e2e/src/calls.test.ts +132 -0
- package/e2e/src/declarations/hello_actor.envelope.json +175 -0
- package/e2e/src/declarations/hello_actor.ts +15 -0
- package/e2e/src/errors.test.ts +107 -0
- package/e2e/src/frontend-headers.test.ts +253 -0
- package/e2e/src/identity.test.ts +61 -0
- package/e2e/src/react.test.tsx +59 -0
- package/e2e/src/replica.ts +70 -0
- package/e2e/src/vite-env.test.ts +108 -0
- package/e2e/test.sh +47 -0
- package/e2e/tsconfig.json +20 -0
- package/e2e/tsconfig.typecheck.json +9 -0
- package/e2e/vitest.config.ts +22 -0
- package/eslint.config.mjs +100 -0
- package/evals/PREREGISTRATION.md +1346 -0
- package/evals/README.md +756 -0
- package/evals/conditions/thin/condition.json +8 -0
- package/evals/conditions/thin/docs/candid-core-cli.README.md +90 -0
- package/evals/conditions/thin/docs/candid-core-schema.README.md +339 -0
- package/evals/conditions/thin/package.json +25 -0
- package/evals/conditions/thin/starter/src/generated/icrc1.ts +57 -0
- package/evals/conditions/thin-guide/condition.json +10 -0
- package/evals/conditions/thin-guide/docs/llms.txt +292 -0
- package/evals/conditions/v3/condition.json +9 -0
- package/evals/conditions/v3/docs/ic-reactor-core.llms.txt +232 -0
- package/evals/conditions/v3/docs/ic-reactor-react.llms.txt +280 -0
- package/evals/conditions/v3/docs/llms-full.txt +1053 -0
- package/evals/conditions/v3/package.json +26 -0
- package/evals/conditions/v3/starter/src/declarations/icrc1.did.d.ts +95 -0
- package/evals/conditions/v3/starter/src/declarations/icrc1.did.js +140 -0
- package/evals/conditions/v4/PORTING.md +384 -0
- package/evals/conditions/v4/README.md +106 -0
- package/evals/conditions/v4/condition.json +5 -0
- package/evals/conditions/v4/docs/llms.txt +323 -0
- package/evals/conditions/v4/package.json +27 -0
- package/evals/conditions/v4/starter/src/generated/icrc1.ts +78 -0
- package/evals/conditions/v4-proto/condition.json +6 -0
- package/evals/conditions/v4-proto/docs/llms.txt +291 -0
- package/evals/conditions/v4-proto/lib/SHIM-NOTES.md +20 -0
- package/evals/conditions/v4-proto/lib/package.json +27 -0
- package/evals/conditions/v4-proto/lib/src/client.ts +471 -0
- package/evals/conditions/v4-proto/lib/src/errors.ts +214 -0
- package/evals/conditions/v4-proto/lib/src/index.ts +36 -0
- package/evals/conditions/v4-proto/lib/src/principal.ts +175 -0
- package/evals/conditions/v4-proto/lib/src/service.ts +69 -0
- package/evals/conditions/v4-proto/lib/src/types.ts +174 -0
- package/evals/conditions/v4-proto/lib/test/runtime.test.ts +170 -0
- package/evals/conditions/v4-proto/lib/test/tsconfig.json +10 -0
- package/evals/conditions/v4-proto/lib/test/types.test-d.ts +145 -0
- package/evals/conditions/v4-proto/lib/test/vitest.config.mjs +8 -0
- package/evals/conditions/v4-proto/lib/tsconfig.json +17 -0
- package/evals/conditions/v4-proto/package.json +26 -0
- package/evals/conditions/v4-proto/starter/src/generated/icrc1.service.ts +19 -0
- package/evals/conditions/v4-proto/starter/src/generated/icrc1.ts +57 -0
- package/evals/drive.mjs +1221 -0
- package/evals/gate.mjs +161 -0
- package/evals/harness/aggregate.mjs +534 -0
- package/evals/harness/aggregate.test.mjs +344 -0
- package/evals/harness/assemble.mjs +216 -0
- package/evals/harness/assemble.test.mjs +143 -0
- package/evals/harness/auth.mjs +91 -0
- package/evals/harness/check-docs.mjs +157 -0
- package/evals/harness/declarations/icrc1.did.d.ts +95 -0
- package/evals/harness/declarations/icrc1.did.js +140 -0
- package/evals/harness/drive-auth.test.mjs +584 -0
- package/evals/harness/drive.test.mjs +509 -0
- package/evals/harness/fake-auth.ts +67 -0
- package/evals/harness/fake-ledger.ts +178 -0
- package/evals/harness/gate-plan.mjs +104 -0
- package/evals/harness/gate-plan.test.mjs +243 -0
- package/evals/harness/icrc1.did +88 -0
- package/evals/harness/judge.mjs +63 -0
- package/evals/harness/judge.test.mjs +81 -0
- package/evals/harness/leak-scan.mjs +1373 -0
- package/evals/harness/leak-scan.test.mjs +1300 -0
- package/evals/harness/probes/amounts.ts +14 -0
- package/evals/harness/probes/node-tool.probe.ts +48 -0
- package/evals/harness/probes/probe.mjs +149 -0
- package/evals/harness/probes/react-wallet.probe.ts +96 -0
- package/evals/harness/public/support/auth.ts +38 -0
- package/evals/harness/public/support/fake-replica.d.ts +28 -0
- package/evals/harness/public/support/fake-replica.js +434 -0
- package/evals/harness/public/support/ledger.idl.d.ts +95 -0
- package/evals/harness/public/support/ledger.idl.js +140 -0
- package/evals/harness/public/support/world.ts +179 -0
- package/evals/harness/runs.mjs +139 -0
- package/evals/harness/sandbox.mjs +88 -0
- package/evals/harness/sandbox.test.mjs +134 -0
- package/evals/harness/ship.mjs +264 -0
- package/evals/harness/ship.test.mjs +552 -0
- package/evals/harness/world.ts +291 -0
- package/evals/package.json +26 -0
- package/evals/pnpm-lock.yaml +1537 -0
- package/evals/pnpm-workspace.yaml +12 -0
- package/evals/results/2026-09-30T14-22-05-924Z/pilot.json +384 -0
- package/evals/results/2026-09-30T14-22-05-924Z/pilot.rescanned.json +404 -0
- package/evals/results/2026-09-30T14-22-05-924Z/pilot.rescanned.rescored.json +404 -0
- package/evals/results/2026-09-30T14-22-05-924Z/plan.json +240 -0
- package/evals/results/2026-09-30T14-22-05-924Z/summary.json +1800 -0
- package/evals/results/2026-09-30T14-22-05-924Z/summary.rescanned.json +1843 -0
- package/evals/results/2026-09-30T14-22-05-924Z/summary.rescanned.rescored.json +2100 -0
- package/evals/results/2026-09-30T15-48-23-343Z/pilot.json +404 -0
- package/evals/results/2026-09-30T15-48-23-343Z/pilot.rescored.json +404 -0
- package/evals/results/2026-09-30T15-48-23-343Z/plan.json +242 -0
- package/evals/results/2026-09-30T15-48-23-343Z/summary.json +1843 -0
- package/evals/results/2026-09-30T15-48-23-343Z/summary.rescored.json +2195 -0
- package/evals/results/2026-10-03-beta1-gate/pilot.json +162 -0
- package/evals/results/2026-10-03-beta1-gate/plan.json +141 -0
- package/evals/results/2026-10-03-beta1-gate/summary.json +983 -0
- package/evals/results/2026-10-05-ga-gate/contaminated-run.json +55 -0
- package/evals/results/2026-10-05-ga-gate/pilot.json +162 -0
- package/evals/results/2026-10-05-ga-gate/plan.json +457 -0
- package/evals/results/2026-10-05-ga-gate/summary.json +1037 -0
- package/evals/results/2026-10-05-ga-gate/summary.rescanned.json +1037 -0
- package/evals/results/README.md +31 -0
- package/evals/runs-pilot.log +150 -0
- package/evals/runs-pilot2.log +150 -0
- package/evals/score.mjs +256 -0
- package/evals/setup.mjs +547 -0
- package/evals/tasks/node-tool/faulty/thin-accepts-exponent/meta.json +5 -0
- package/evals/tasks/node-tool/faulty/thin-accepts-exponent/src/index.ts +121 -0
- package/evals/tasks/node-tool/faulty/thin-anonymous-transfer/meta.json +5 -0
- package/evals/tasks/node-tool/faulty/thin-anonymous-transfer/src/index.ts +116 -0
- package/evals/tasks/node-tool/faulty/thin-every-reject-may-have-executed/meta.json +9 -0
- package/evals/tasks/node-tool/faulty/thin-every-reject-may-have-executed/src/index.ts +118 -0
- package/evals/tasks/node-tool/faulty/thin-fetches-root-key-off-local/meta.json +5 -0
- package/evals/tasks/node-tool/faulty/thin-fetches-root-key-off-local/src/index.ts +118 -0
- package/evals/tasks/node-tool/faulty/thin-ignores-root-key/meta.json +5 -0
- package/evals/tasks/node-tool/faulty/thin-ignores-root-key/src/index.ts +117 -0
- package/evals/tasks/node-tool/faulty/thin-misclassifies-reject-codes/meta.json +9 -0
- package/evals/tasks/node-tool/faulty/thin-misclassifies-reject-codes/src/index.ts +119 -0
- package/evals/tasks/node-tool/faulty/thin-no-nat64-cap/meta.json +9 -0
- package/evals/tasks/node-tool/faulty/thin-no-nat64-cap/src/index.ts +118 -0
- package/evals/tasks/node-tool/faulty/thin-number-amount/meta.json +10 -0
- package/evals/tasks/node-tool/faulty/thin-number-amount/src/index.ts +117 -0
- package/evals/tasks/node-tool/faulty/thin-truncates-fraction-digits/meta.json +5 -0
- package/evals/tasks/node-tool/faulty/thin-truncates-fraction-digits/src/index.ts +120 -0
- package/evals/tasks/node-tool/faulty/thin-unvalidated-recipient/meta.json +5 -0
- package/evals/tasks/node-tool/faulty/thin-unvalidated-recipient/src/index.ts +118 -0
- package/evals/tasks/node-tool/faulty/v3-retry-call-errors/meta.json +11 -0
- package/evals/tasks/node-tool/faulty/v3-retry-call-errors/src/index.ts +149 -0
- package/evals/tasks/node-tool/faulty/v4-anonymous-identity-sent/meta.json +5 -0
- package/evals/tasks/node-tool/faulty/v4-anonymous-identity-sent/src/index.ts +71 -0
- package/evals/tasks/node-tool/faulty/v4-never-may-have-executed/meta.json +9 -0
- package/evals/tasks/node-tool/faulty/v4-never-may-have-executed/src/index.ts +84 -0
- package/evals/tasks/node-tool/faulty/v4-proto-never-may-have-executed/meta.json +9 -0
- package/evals/tasks/node-tool/faulty/v4-proto-never-may-have-executed/src/index.ts +72 -0
- package/evals/tasks/node-tool/faulty/v4-proto-refuses-nat64-max/meta.json +5 -0
- package/evals/tasks/node-tool/faulty/v4-proto-refuses-nat64-max/src/index.ts +72 -0
- package/evals/tasks/node-tool/faulty/v4-refuses-nat64-max/meta.json +5 -0
- package/evals/tasks/node-tool/faulty/v4-refuses-nat64-max/src/index.ts +84 -0
- package/evals/tasks/node-tool/hidden/node-tool.test.ts +312 -0
- package/evals/tasks/node-tool/prompt.md +55 -0
- package/evals/tasks/node-tool/prompt.minimal.md +30 -0
- package/evals/tasks/node-tool/solutions/thin/reference/src/index.ts +118 -0
- package/evals/tasks/node-tool/solutions/thin/reference-module-scope/src/index.ts +145 -0
- package/evals/tasks/node-tool/solutions/thin-guide/reference/src/index.ts +118 -0
- package/evals/tasks/node-tool/solutions/thin-guide/reference-module-scope/src/index.ts +145 -0
- package/evals/tasks/node-tool/solutions/v3/reference/src/index.ts +140 -0
- package/evals/tasks/node-tool/solutions/v3/reference-module-scope/src/index.ts +153 -0
- package/evals/tasks/node-tool/solutions/v4/reference/src/index.ts +84 -0
- package/evals/tasks/node-tool/solutions/v4/reference-module-scope/src/index.ts +105 -0
- package/evals/tasks/node-tool/solutions/v4-proto/reference/src/index.ts +72 -0
- package/evals/tasks/node-tool/solutions/v4-proto/reference-module-scope/src/index.ts +87 -0
- package/evals/tasks/node-tool/starter/src/contract.ts +31 -0
- package/evals/tasks/node-tool/starter/src/index.ts +7 -0
- package/evals/tasks/node-tool/starter/test/smoke.test.ts +22 -0
- package/evals/tasks/node-tool/starter/tsconfig.json +17 -0
- package/evals/tasks/node-tool/task.json +63 -0
- package/evals/tasks/react-wallet/faulty/thin-accepts-exponent/meta.json +5 -0
- package/evals/tasks/react-wallet/faulty/thin-accepts-exponent/src/Wallet.tsx +216 -0
- package/evals/tasks/react-wallet/faulty/thin-anonymous-transfer/meta.json +5 -0
- package/evals/tasks/react-wallet/faulty/thin-anonymous-transfer/src/Wallet.tsx +212 -0
- package/evals/tasks/react-wallet/faulty/thin-both-auth-buttons/meta.json +5 -0
- package/evals/tasks/react-wallet/faulty/thin-both-auth-buttons/src/Wallet.tsx +210 -0
- package/evals/tasks/react-wallet/faulty/thin-constant-balance-key/meta.json +8 -0
- package/evals/tasks/react-wallet/faulty/thin-constant-balance-key/src/Wallet.tsx +213 -0
- package/evals/tasks/react-wallet/faulty/thin-no-nat64-cap/meta.json +9 -0
- package/evals/tasks/react-wallet/faulty/thin-no-nat64-cap/src/Wallet.tsx +213 -0
- package/evals/tasks/react-wallet/faulty/thin-number-balance/meta.json +5 -0
- package/evals/tasks/react-wallet/faulty/thin-number-balance/src/Wallet.tsx +213 -0
- package/evals/tasks/react-wallet/faulty/thin-transfer-as-query/meta.json +5 -0
- package/evals/tasks/react-wallet/faulty/thin-transfer-as-query/src/Wallet.tsx +254 -0
- package/evals/tasks/react-wallet/faulty/thin-truncates-fraction-digits/meta.json +5 -0
- package/evals/tasks/react-wallet/faulty/thin-truncates-fraction-digits/src/Wallet.tsx +215 -0
- package/evals/tasks/react-wallet/faulty/thin-unguarded-balance-effect/meta.json +5 -0
- package/evals/tasks/react-wallet/faulty/thin-unguarded-balance-effect/src/Wallet.tsx +214 -0
- package/evals/tasks/react-wallet/faulty/v3-http-4xx-unknown/meta.json +5 -0
- package/evals/tasks/react-wallet/faulty/v3-http-4xx-unknown/src/Wallet.tsx +224 -0
- package/evals/tasks/react-wallet/faulty/v3-mutation-retry-3/meta.json +12 -0
- package/evals/tasks/react-wallet/faulty/v3-mutation-retry-3/src/Wallet.tsx +225 -0
- package/evals/tasks/react-wallet/faulty/v3-unknown-as-error/meta.json +11 -0
- package/evals/tasks/react-wallet/faulty/v3-unknown-as-error/src/Wallet.tsx +182 -0
- package/evals/tasks/react-wallet/faulty/v4-every-reject-unknown/meta.json +5 -0
- package/evals/tasks/react-wallet/faulty/v4-every-reject-unknown/src/Wallet.tsx +160 -0
- package/evals/tasks/react-wallet/faulty/v4-keep-previous-data/meta.json +5 -0
- package/evals/tasks/react-wallet/faulty/v4-keep-previous-data/src/Wallet.tsx +166 -0
- package/evals/tasks/react-wallet/faulty/v4-proto-every-reject-unknown/meta.json +5 -0
- package/evals/tasks/react-wallet/faulty/v4-proto-every-reject-unknown/src/Wallet.tsx +161 -0
- package/evals/tasks/react-wallet/faulty/v4-proto-keep-previous-data/meta.json +5 -0
- package/evals/tasks/react-wallet/faulty/v4-proto-keep-previous-data/src/Wallet.tsx +163 -0
- package/evals/tasks/react-wallet/faulty/v4-proto-retry-spread/meta.json +12 -0
- package/evals/tasks/react-wallet/faulty/v4-proto-retry-spread/src/Wallet.tsx +162 -0
- package/evals/tasks/react-wallet/faulty/v4-proto-status-not-idle/meta.json +5 -0
- package/evals/tasks/react-wallet/faulty/v4-proto-status-not-idle/src/Wallet.tsx +163 -0
- package/evals/tasks/react-wallet/faulty/v4-retry-spread/meta.json +12 -0
- package/evals/tasks/react-wallet/faulty/v4-retry-spread/src/Wallet.tsx +163 -0
- package/evals/tasks/react-wallet/faulty/v4-status-not-idle/meta.json +5 -0
- package/evals/tasks/react-wallet/faulty/v4-status-not-idle/src/Wallet.tsx +162 -0
- package/evals/tasks/react-wallet/hidden/react-wallet.test.ts +536 -0
- package/evals/tasks/react-wallet/prompt.md +88 -0
- package/evals/tasks/react-wallet/prompt.minimal.md +51 -0
- package/evals/tasks/react-wallet/solutions/thin/reference/src/Wallet.tsx +213 -0
- package/evals/tasks/react-wallet/solutions/thin/reference-module-scope/src/Wallet.tsx +227 -0
- package/evals/tasks/react-wallet/solutions/thin-guide/reference/src/Wallet.tsx +213 -0
- package/evals/tasks/react-wallet/solutions/thin-guide/reference-module-scope/src/Wallet.tsx +227 -0
- package/evals/tasks/react-wallet/solutions/v3/reference/src/Wallet.tsx +224 -0
- package/evals/tasks/react-wallet/solutions/v3/reference-module-scope/src/Wallet.tsx +230 -0
- package/evals/tasks/react-wallet/solutions/v4/reference/src/Wallet.tsx +160 -0
- package/evals/tasks/react-wallet/solutions/v4/reference-module-scope/src/Wallet.tsx +178 -0
- package/evals/tasks/react-wallet/solutions/v4-proto/reference/src/Wallet.tsx +161 -0
- package/evals/tasks/react-wallet/solutions/v4-proto/reference-module-scope/src/Wallet.tsx +161 -0
- package/evals/tasks/react-wallet/starter/src/Wallet.tsx +12 -0
- package/evals/tasks/react-wallet/starter/src/auth.ts +16 -0
- package/evals/tasks/react-wallet/starter/src/config.ts +14 -0
- package/evals/tasks/react-wallet/starter/src/ii-auth.ts +43 -0
- package/evals/tasks/react-wallet/starter/src/main.tsx +15 -0
- package/evals/tasks/react-wallet/starter/test/smoke.test.ts +34 -0
- package/evals/tasks/react-wallet/starter/tsconfig.json +18 -0
- package/evals/tasks/react-wallet/task.json +84 -0
- package/examples/canister-studio/.stackblitzrc +4 -0
- package/examples/canister-studio/README.md +183 -0
- package/examples/canister-studio/did/ckbtc_minter.did +806 -0
- package/examples/canister-studio/did/icp_ledger.did +586 -0
- package/examples/canister-studio/did/icrc1.did +88 -0
- package/examples/canister-studio/package.json +45 -0
- package/examples/canister-studio/scripts/smoke.ts +188 -0
- package/examples/canister-studio/src/calls/CacheKeyPanel.tsx +104 -0
- package/examples/canister-studio/src/calls/ConfirmWrite.tsx +265 -0
- package/examples/canister-studio/src/calls/ErrorPanel.test.tsx +113 -0
- package/examples/canister-studio/src/calls/ErrorPanel.tsx +214 -0
- package/examples/canister-studio/src/calls/MethodRunner.test.tsx +354 -0
- package/examples/canister-studio/src/calls/MethodRunner.tsx +57 -0
- package/examples/canister-studio/src/calls/ReadRunner.tsx +244 -0
- package/examples/canister-studio/src/calls/ResendPanel.tsx +165 -0
- package/examples/canister-studio/src/calls/ShareLink.tsx +59 -0
- package/examples/canister-studio/src/calls/WriteRunner.test.tsx +678 -0
- package/examples/canister-studio/src/calls/WriteRunner.tsx +670 -0
- package/examples/canister-studio/src/calls/dedupe.ts +189 -0
- package/examples/canister-studio/src/calls/error-info.ts +168 -0
- package/examples/canister-studio/src/calls/history.test.ts +284 -0
- package/examples/canister-studio/src/calls/history.ts +287 -0
- package/examples/canister-studio/src/calls/kinds.ts +68 -0
- package/examples/canister-studio/src/calls/prepare.ts +32 -0
- package/examples/canister-studio/src/calls/query-options.ts +30 -0
- package/examples/canister-studio/src/calls/read.ts +47 -0
- package/examples/canister-studio/src/calls/readback.ts +100 -0
- package/examples/canister-studio/src/calls/record.ts +123 -0
- package/examples/canister-studio/src/calls/safe-calls.test.ts +299 -0
- package/examples/canister-studio/src/calls/share.ts +46 -0
- package/examples/canister-studio/src/calls/testing/doubles.tsx +108 -0
- package/examples/canister-studio/src/calls/testing/fixtures.ts +185 -0
- package/examples/canister-studio/src/calls/useCanisterHandle.ts +35 -0
- package/examples/canister-studio/src/canisters/ckbtc_minter.envelope.json +4228 -0
- package/examples/canister-studio/src/canisters/ckbtc_minter.ts +868 -0
- package/examples/canister-studio/src/canisters/icp_ledger.envelope.json +3454 -0
- package/examples/canister-studio/src/canisters/icp_ledger.ts +584 -0
- package/examples/canister-studio/src/canisters/icrc1.envelope.json +840 -0
- package/examples/canister-studio/src/canisters/icrc1.ts +78 -0
- package/examples/canister-studio/src/components/ActionButton.tsx +32 -0
- package/examples/canister-studio/src/components/AppHeader.tsx +83 -0
- package/examples/canister-studio/src/components/AppShell.tsx +29 -0
- package/examples/canister-studio/src/components/AuthButton.tsx +79 -0
- package/examples/canister-studio/src/components/Badge.tsx +79 -0
- package/examples/canister-studio/src/components/CanisterHeader.tsx +200 -0
- package/examples/canister-studio/src/components/CanisterJump.tsx +130 -0
- package/examples/canister-studio/src/components/Card.tsx +64 -0
- package/examples/canister-studio/src/components/Code.tsx +101 -0
- package/examples/canister-studio/src/components/CopyButton.tsx +126 -0
- package/examples/canister-studio/src/components/Disclosure.tsx +34 -0
- package/examples/canister-studio/src/components/EmptyState.tsx +34 -0
- package/examples/canister-studio/src/components/MethodList.test.tsx +137 -0
- package/examples/canister-studio/src/components/MethodList.tsx +244 -0
- package/examples/canister-studio/src/components/Notice.tsx +36 -0
- package/examples/canister-studio/src/components/ProvenanceBadge.tsx +44 -0
- package/examples/canister-studio/src/components/RouteError.tsx +42 -0
- package/examples/canister-studio/src/components/SectionBoundary.tsx +76 -0
- package/examples/canister-studio/src/components/Spinner.tsx +33 -0
- package/examples/canister-studio/src/components/Tabs.tsx +96 -0
- package/examples/canister-studio/src/components/canister/CanisterLoadFailure.test.tsx +56 -0
- package/examples/canister-studio/src/components/canister/CanisterLoadFailure.tsx +165 -0
- package/examples/canister-studio/src/components/canister/CanisterNotFound.tsx +59 -0
- package/examples/canister-studio/src/components/canister/CanisterPending.tsx +33 -0
- package/examples/canister-studio/src/components/canister/MethodOverview.tsx +93 -0
- package/examples/canister-studio/src/components/canister/MethodWorkspace.test.tsx +201 -0
- package/examples/canister-studio/src/components/canister/MethodWorkspace.tsx +187 -0
- package/examples/canister-studio/src/components/canister/shared-call.test.ts +186 -0
- package/examples/canister-studio/src/components/canister/shared-call.ts +133 -0
- package/examples/canister-studio/src/components/canister/shared-link-loader.test.ts +116 -0
- package/examples/canister-studio/src/components/canister/use-canister-page.ts +44 -0
- package/examples/canister-studio/src/components/canister/workspace-key.test.ts +27 -0
- package/examples/canister-studio/src/components/canister/workspace-key.ts +36 -0
- package/examples/canister-studio/src/components/canister-id-input.ts +69 -0
- package/examples/canister-studio/src/components/canister-names.ts +11 -0
- package/examples/canister-studio/src/components/download.ts +34 -0
- package/examples/canister-studio/src/components/fallbacks.tsx +33 -0
- package/examples/canister-studio/src/components/helpers.test.ts +107 -0
- package/examples/canister-studio/src/components/history/HistoryList.tsx +284 -0
- package/examples/canister-studio/src/components/home/FeaturedLedger.tsx +149 -0
- package/examples/canister-studio/src/components/home/OpenCanister.tsx +99 -0
- package/examples/canister-studio/src/components/home/featured.test.tsx +92 -0
- package/examples/canister-studio/src/components/home/featured.ts +64 -0
- package/examples/canister-studio/src/components/interface/CandidTab.tsx +38 -0
- package/examples/canister-studio/src/components/interface/CompatReport.tsx +92 -0
- package/examples/canister-studio/src/components/interface/CompatibilityTab.tsx +190 -0
- package/examples/canister-studio/src/components/interface/ProjectTab.tsx +196 -0
- package/examples/canister-studio/src/components/interface/TypeScriptTab.tsx +114 -0
- package/examples/canister-studio/src/components/interface/tools.test.tsx +169 -0
- package/examples/canister-studio/src/components/modes.ts +31 -0
- package/examples/canister-studio/src/components/playground/MethodPicker.tsx +67 -0
- package/examples/canister-studio/src/components/playground/PlaygroundForms.tsx +112 -0
- package/examples/canister-studio/src/components/playground/PlaygroundTools.tsx +219 -0
- package/examples/canister-studio/src/components/playground/sample.ts +43 -0
- package/examples/canister-studio/src/components/playground/target.test.tsx +86 -0
- package/examples/canister-studio/src/components/primitives.test.tsx +121 -0
- package/examples/canister-studio/src/components/provenance.ts +38 -0
- package/examples/canister-studio/src/components/route-render.test.tsx +71 -0
- package/examples/canister-studio/src/components/use-task.ts +56 -0
- package/examples/canister-studio/src/components/wallet/BalancePanel.tsx +110 -0
- package/examples/canister-studio/src/components/wallet/LedgerSummary.tsx +63 -0
- package/examples/canister-studio/src/components/wallet/MinterPanel.tsx +255 -0
- package/examples/canister-studio/src/components/wallet/SendPanel.test.tsx +297 -0
- package/examples/canister-studio/src/components/wallet/SendPanel.tsx +446 -0
- package/examples/canister-studio/src/components/wallet/ledgers.test.ts +36 -0
- package/examples/canister-studio/src/components/wallet/ledgers.ts +111 -0
- package/examples/canister-studio/src/forms/JsonPanel.tsx +157 -0
- package/examples/canister-studio/src/forms/MethodForm.test.tsx +369 -0
- package/examples/canister-studio/src/forms/MethodForm.tsx +368 -0
- package/examples/canister-studio/src/forms/TypedForm.tsx +55 -0
- package/examples/canister-studio/src/forms/context.ts +62 -0
- package/examples/canister-studio/src/forms/convert.ts +131 -0
- package/examples/canister-studio/src/forms/edge.test.ts +252 -0
- package/examples/canister-studio/src/forms/engine.test.ts +358 -0
- package/examples/canister-studio/src/forms/engine.ts +1492 -0
- package/examples/canister-studio/src/forms/fields/BytesField.tsx +210 -0
- package/examples/canister-studio/src/forms/fields/Field.tsx +106 -0
- package/examples/canister-studio/src/forms/fields/FieldShell.tsx +101 -0
- package/examples/canister-studio/src/forms/fields/Group.tsx +74 -0
- package/examples/canister-studio/src/forms/fields/ListField.tsx +256 -0
- package/examples/canister-studio/src/forms/fields/Segmented.tsx +78 -0
- package/examples/canister-studio/src/forms/fields/TimestampField.tsx +108 -0
- package/examples/canister-studio/src/forms/fields/UnitsField.tsx +119 -0
- package/examples/canister-studio/src/forms/fields/composites.tsx +389 -0
- package/examples/canister-studio/src/forms/fields/leaves.tsx +350 -0
- package/examples/canister-studio/src/forms/fields.test.tsx +396 -0
- package/examples/canister-studio/src/forms/helpers.test.ts +225 -0
- package/examples/canister-studio/src/forms/hints.ts +128 -0
- package/examples/canister-studio/src/forms/json.ts +119 -0
- package/examples/canister-studio/src/forms/parsing.test.ts +217 -0
- package/examples/canister-studio/src/forms/useMethodForm.ts +251 -0
- package/examples/canister-studio/src/interface/browser.test.ts +23 -0
- package/examples/canister-studio/src/interface/browser.ts +153 -0
- package/examples/canister-studio/src/interface/cache.ts +68 -0
- package/examples/canister-studio/src/interface/cli-cache.test.ts +155 -0
- package/examples/canister-studio/src/interface/cli-cache.ts +125 -0
- package/examples/canister-studio/src/interface/compile.server.test.ts +198 -0
- package/examples/canister-studio/src/interface/compile.server.ts +262 -0
- package/examples/canister-studio/src/interface/compile.test.ts +108 -0
- package/examples/canister-studio/src/interface/compile.ts +305 -0
- package/examples/canister-studio/src/interface/docs.test.ts +75 -0
- package/examples/canister-studio/src/interface/docs.ts +100 -0
- package/examples/canister-studio/src/interface/functions.test.ts +42 -0
- package/examples/canister-studio/src/interface/functions.ts +200 -0
- package/examples/canister-studio/src/interface/live-candid.server.ts +91 -0
- package/examples/canister-studio/src/interface/live-loader.test.ts +515 -0
- package/examples/canister-studio/src/interface/live-loader.ts +364 -0
- package/examples/canister-studio/src/interface/load.test.ts +328 -0
- package/examples/canister-studio/src/interface/load.ts +249 -0
- package/examples/canister-studio/src/interface/read-candid.test.ts +185 -0
- package/examples/canister-studio/src/interface/read-candid.ts +233 -0
- package/examples/canister-studio/src/interface/server-result.ts +42 -0
- package/examples/canister-studio/src/interface/typed.ts +68 -0
- package/examples/canister-studio/src/interface/types.ts +121 -0
- package/examples/canister-studio/src/lib/format.test.ts +107 -0
- package/examples/canister-studio/src/lib/format.ts +139 -0
- package/examples/canister-studio/src/lib/hex.test.ts +43 -0
- package/examples/canister-studio/src/lib/hex.ts +33 -0
- package/examples/canister-studio/src/lib/ids.test.ts +70 -0
- package/examples/canister-studio/src/lib/ids.ts +93 -0
- package/examples/canister-studio/src/lib/reactor.test.ts +55 -0
- package/examples/canister-studio/src/lib/reactor.ts +55 -0
- package/examples/canister-studio/src/lib/registry.test.ts +74 -0
- package/examples/canister-studio/src/lib/registry.ts +238 -0
- package/examples/canister-studio/src/lib/schema.ts +148 -0
- package/examples/canister-studio/src/routeTree.gen.ts +227 -0
- package/examples/canister-studio/src/router.test.ts +290 -0
- package/examples/canister-studio/src/router.tsx +127 -0
- package/examples/canister-studio/src/routes/__root.tsx +58 -0
- package/examples/canister-studio/src/routes/canister.$canisterId.index.tsx +172 -0
- package/examples/canister-studio/src/routes/canister.$canisterId.interface.tsx +98 -0
- package/examples/canister-studio/src/routes/canister.$canisterId.tsx +91 -0
- package/examples/canister-studio/src/routes/history.tsx +55 -0
- package/examples/canister-studio/src/routes/index.tsx +169 -0
- package/examples/canister-studio/src/routes/playground.tsx +286 -0
- package/examples/canister-studio/src/routes/safety.tsx +57 -0
- package/examples/canister-studio/src/routes/wallet.tsx +213 -0
- package/examples/canister-studio/src/safety/LabTransferForm.tsx +84 -0
- package/examples/canister-studio/src/safety/RequestLog.tsx +79 -0
- package/examples/canister-studio/src/safety/SafetyLab.test.tsx +89 -0
- package/examples/canister-studio/src/safety/SafetyLab.tsx +140 -0
- package/examples/canister-studio/src/safety/ScenarioCard.tsx +262 -0
- package/examples/canister-studio/src/safety/lab-run.ts +283 -0
- package/examples/canister-studio/src/safety/mock-ledger.test.ts +99 -0
- package/examples/canister-studio/src/safety/mock-ledger.ts +263 -0
- package/examples/canister-studio/src/safety/scenarios.test.ts +157 -0
- package/examples/canister-studio/src/safety/scenarios.ts +924 -0
- package/examples/canister-studio/src/styles.css +3453 -0
- package/examples/canister-studio/src/styles.test.ts +46 -0
- package/examples/canister-studio/src/values/CallPreview.test.tsx +86 -0
- package/examples/canister-studio/src/values/CallPreview.tsx +148 -0
- package/examples/canister-studio/src/values/ErrValueView.tsx +66 -0
- package/examples/canister-studio/src/values/Inspector.tsx +133 -0
- package/examples/canister-studio/src/values/ReplyView.test.tsx +341 -0
- package/examples/canister-studio/src/values/ReplyView.tsx +164 -0
- package/examples/canister-studio/src/values/candid-text.test.ts +516 -0
- package/examples/canister-studio/src/values/candid-text.ts +479 -0
- package/examples/canister-studio/src/values/hints.ts +58 -0
- package/examples/canister-studio/src/values/json.test.ts +66 -0
- package/examples/canister-studio/src/values/json.ts +31 -0
- package/examples/canister-studio/src/values/leaves.tsx +309 -0
- package/examples/canister-studio/src/values/schema.test.ts +123 -0
- package/examples/canister-studio/src/values/schema.ts +78 -0
- package/examples/canister-studio/src/values/test-router.tsx +21 -0
- package/examples/canister-studio/src/values/tree.tsx +670 -0
- package/examples/canister-studio/src/values/use-sha256.ts +29 -0
- package/examples/canister-studio/tsconfig.json +20 -0
- package/examples/canister-studio/vite.config.ts +50 -0
- package/examples/canister-studio/vitest.config.ts +20 -0
- package/examples/icrc-ledger/.stackblitzrc +4 -0
- package/examples/icrc-ledger/README.md +100 -0
- package/examples/icrc-ledger/ckbtc_minter.did +12 -0
- package/examples/icrc-ledger/icp_ledger.did +147 -0
- package/examples/icrc-ledger/icrc1.did +88 -0
- package/examples/icrc-ledger/index.html +13 -0
- package/examples/icrc-ledger/package.json +40 -0
- package/examples/icrc-ledger/scripts/smoke.ts +151 -0
- package/examples/icrc-ledger/src/App.tsx +71 -0
- package/examples/icrc-ledger/src/ErrorPanel.tsx +105 -0
- package/examples/icrc-ledger/src/MainnetTab.tsx +450 -0
- package/examples/icrc-ledger/src/SandboxTab.test.tsx +379 -0
- package/examples/icrc-ledger/src/SandboxTab.tsx +761 -0
- package/examples/icrc-ledger/src/blocks.test.ts +247 -0
- package/examples/icrc-ledger/src/blocks.ts +140 -0
- package/examples/icrc-ledger/src/canisters/ckbtc_minter.envelope.json +96 -0
- package/examples/icrc-ledger/src/canisters/ckbtc_minter.ts +16 -0
- package/examples/icrc-ledger/src/canisters/icp_ledger.envelope.json +690 -0
- package/examples/icrc-ledger/src/canisters/icp_ledger.ts +223 -0
- package/examples/icrc-ledger/src/canisters/icrc1.envelope.json +840 -0
- package/examples/icrc-ledger/src/canisters/icrc1.ts +78 -0
- package/examples/icrc-ledger/src/format.test.ts +41 -0
- package/examples/icrc-ledger/src/format.ts +68 -0
- package/examples/icrc-ledger/src/ledger.ts +15 -0
- package/examples/icrc-ledger/src/main.tsx +10 -0
- package/examples/icrc-ledger/src/minter.ts +16 -0
- package/examples/icrc-ledger/src/sandbox.test.ts +464 -0
- package/examples/icrc-ledger/src/sandbox.ts +281 -0
- package/examples/icrc-ledger/src/styles.css +391 -0
- package/examples/icrc-ledger/src/transfer-form.test.ts +62 -0
- package/examples/icrc-ledger/src/transfer-form.ts +97 -0
- package/examples/icrc-ledger/tsconfig.json +19 -0
- package/examples/icrc-ledger/vite.config.ts +44 -0
- package/examples/icrc-ledger/vitest.config.ts +12 -0
- package/examples/next-ssr/.stackblitzrc +4 -0
- package/examples/next-ssr/README.md +112 -0
- package/examples/next-ssr/icrc1.did +88 -0
- package/examples/next-ssr/next.config.ts +10 -0
- package/examples/next-ssr/package.json +41 -0
- package/examples/next-ssr/scripts/smoke.ts +169 -0
- package/examples/next-ssr/src/app/account/CertifiedBalances.tsx +58 -0
- package/examples/next-ssr/src/app/account/account.test.tsx +165 -0
- package/examples/next-ssr/src/app/account/page.tsx +82 -0
- package/examples/next-ssr/src/app/api/balance/[ledger]/[principal]/route.ts +10 -0
- package/examples/next-ssr/src/app/globals.css +278 -0
- package/examples/next-ssr/src/app/layout.tsx +34 -0
- package/examples/next-ssr/src/app/page.tsx +46 -0
- package/examples/next-ssr/src/app/providers.browser.test.tsx +127 -0
- package/examples/next-ssr/src/app/providers.test.tsx +73 -0
- package/examples/next-ssr/src/app/providers.tsx +60 -0
- package/examples/next-ssr/src/canisters/icrc1.envelope.json +840 -0
- package/examples/next-ssr/src/canisters/icrc1.ts +78 -0
- package/examples/next-ssr/src/components/BalanceTable.tsx +43 -0
- package/examples/next-ssr/src/components/LedgerCard.test.tsx +96 -0
- package/examples/next-ssr/src/components/LedgerCard.tsx +230 -0
- package/examples/next-ssr/src/components/LedgerError.tsx +32 -0
- package/examples/next-ssr/src/components/LedgerSections.tsx +22 -0
- package/examples/next-ssr/src/components/MyBalances.test.tsx +253 -0
- package/examples/next-ssr/src/components/MyBalances.tsx +129 -0
- package/examples/next-ssr/src/components/SessionBadge.tsx +18 -0
- package/examples/next-ssr/src/components/hydration.test.tsx +259 -0
- package/examples/next-ssr/src/components/server-data.ts +10 -0
- package/examples/next-ssr/src/format.ts +46 -0
- package/examples/next-ssr/src/ledgers.ts +38 -0
- package/examples/next-ssr/src/server/balance-route.test.ts +151 -0
- package/examples/next-ssr/src/server/balance-route.ts +157 -0
- package/examples/next-ssr/src/server/error-summary.test.ts +34 -0
- package/examples/next-ssr/src/server/error-summary.ts +37 -0
- package/examples/next-ssr/src/server/parse-owner.test.ts +39 -0
- package/examples/next-ssr/src/server/parse-owner.ts +34 -0
- package/examples/next-ssr/src/server/prefetch-ledgers.test.ts +137 -0
- package/examples/next-ssr/src/server/prefetch-ledgers.ts +70 -0
- package/examples/next-ssr/src/server/read-balances.test.ts +103 -0
- package/examples/next-ssr/src/server/read-balances.ts +78 -0
- package/examples/next-ssr/src/server/request-client.rsc.test.tsx +110 -0
- package/examples/next-ssr/src/server/request-client.ts +24 -0
- package/examples/next-ssr/src/testing/mock-ledgers.ts +115 -0
- package/examples/next-ssr/src/testing/react-server-dom-turbopack.d.ts +15 -0
- package/examples/next-ssr/src/testing/setup.ts +10 -0
- package/examples/next-ssr/tsconfig.json +31 -0
- package/examples/next-ssr/vitest.config.ts +59 -0
- package/examples/node-agent-tool/.stackblitzrc +4 -0
- package/examples/node-agent-tool/README.md +165 -0
- package/examples/node-agent-tool/icp.yaml +11 -0
- package/examples/node-agent-tool/icrc1.did +88 -0
- package/examples/node-agent-tool/package.json +32 -0
- package/examples/node-agent-tool/src/canisters/icrc1.envelope.json +840 -0
- package/examples/node-agent-tool/src/canisters/icrc1.ts +78 -0
- package/examples/node-agent-tool/src/cli.test.ts +64 -0
- package/examples/node-agent-tool/src/cli.ts +23 -0
- package/examples/node-agent-tool/src/command-line.ts +159 -0
- package/examples/node-agent-tool/src/commands/balance.ts +73 -0
- package/examples/node-agent-tool/src/commands/demo.test.ts +51 -0
- package/examples/node-agent-tool/src/commands/demo.ts +359 -0
- package/examples/node-agent-tool/src/commands/info.ts +69 -0
- package/examples/node-agent-tool/src/commands/reads.test.ts +133 -0
- package/examples/node-agent-tool/src/commands/resend.test.ts +363 -0
- package/examples/node-agent-tool/src/commands/transfer.test.ts +313 -0
- package/examples/node-agent-tool/src/commands/transfer.ts +415 -0
- package/examples/node-agent-tool/src/commands/watch.test.ts +159 -0
- package/examples/node-agent-tool/src/commands/watch.ts +135 -0
- package/examples/node-agent-tool/src/commands/whoami.ts +36 -0
- package/examples/node-agent-tool/src/context.ts +20 -0
- package/examples/node-agent-tool/src/dispatch.ts +70 -0
- package/examples/node-agent-tool/src/failure.test.ts +59 -0
- package/examples/node-agent-tool/src/failure.ts +176 -0
- package/examples/node-agent-tool/src/identity.test.ts +242 -0
- package/examples/node-agent-tool/src/identity.ts +228 -0
- package/examples/node-agent-tool/src/input.ts +110 -0
- package/examples/node-agent-tool/src/ledgers.test.ts +74 -0
- package/examples/node-agent-tool/src/ledgers.ts +62 -0
- package/examples/node-agent-tool/src/mock-ledger.ts +211 -0
- package/examples/node-agent-tool/src/network.test.ts +128 -0
- package/examples/node-agent-tool/src/network.ts +101 -0
- package/examples/node-agent-tool/src/output.test.ts +208 -0
- package/examples/node-agent-tool/src/output.ts +163 -0
- package/examples/node-agent-tool/src/run.ts +73 -0
- package/examples/node-agent-tool/src/test-kit.ts +167 -0
- package/examples/node-agent-tool/tsconfig.json +18 -0
- package/examples/node-agent-tool/vitest.config.ts +8 -0
- package/examples/vite-wallet/.stackblitzrc +4 -0
- package/examples/vite-wallet/Cargo.lock +646 -0
- package/examples/vite-wallet/Cargo.toml +5 -0
- package/examples/vite-wallet/README.md +107 -0
- package/examples/vite-wallet/backend/Cargo.toml +12 -0
- package/examples/vite-wallet/backend/backend.did +37 -0
- package/examples/vite-wallet/backend/src/lib.rs +133 -0
- package/examples/vite-wallet/icp.yaml +44 -0
- package/examples/vite-wallet/index.html +13 -0
- package/examples/vite-wallet/ledger.did +54 -0
- package/examples/vite-wallet/package.json +46 -0
- package/examples/vite-wallet/public/.ic-assets.json5 +26 -0
- package/examples/vite-wallet/scripts/faucet-args.test.ts +30 -0
- package/examples/vite-wallet/scripts/faucet-args.ts +41 -0
- package/examples/vite-wallet/scripts/faucet.ts +41 -0
- package/examples/vite-wallet/src/AddressBook.test.tsx +191 -0
- package/examples/vite-wallet/src/AddressBook.tsx +147 -0
- package/examples/vite-wallet/src/App.tsx +53 -0
- package/examples/vite-wallet/src/Balance.test.tsx +57 -0
- package/examples/vite-wallet/src/Balance.tsx +58 -0
- package/examples/vite-wallet/src/EnvironmentPanel.test.tsx +83 -0
- package/examples/vite-wallet/src/EnvironmentPanel.tsx +103 -0
- package/examples/vite-wallet/src/ErrorNote.tsx +70 -0
- package/examples/vite-wallet/src/Profile.test.tsx +145 -0
- package/examples/vite-wallet/src/Profile.tsx +92 -0
- package/examples/vite-wallet/src/SendIcp.test.tsx +231 -0
- package/examples/vite-wallet/src/SendIcp.tsx +244 -0
- package/examples/vite-wallet/src/SendToContact.test.tsx +113 -0
- package/examples/vite-wallet/src/SendToContact.tsx +102 -0
- package/examples/vite-wallet/src/SignIn.test.tsx +106 -0
- package/examples/vite-wallet/src/SignIn.tsx +120 -0
- package/examples/vite-wallet/src/Wallet.test.tsx +89 -0
- package/examples/vite-wallet/src/account-switch.test.tsx +108 -0
- package/examples/vite-wallet/src/auth/dev-accounts.test.ts +113 -0
- package/examples/vite-wallet/src/auth/dev-accounts.ts +216 -0
- package/examples/vite-wallet/src/auth/local-page.test.ts +28 -0
- package/examples/vite-wallet/src/auth/local-page.ts +20 -0
- package/examples/vite-wallet/src/auth/wallet-auth.test.ts +159 -0
- package/examples/vite-wallet/src/auth/wallet-auth.ts +131 -0
- package/examples/vite-wallet/src/canisters/backend.envelope.json +275 -0
- package/examples/vite-wallet/src/canisters/backend.ts +58 -0
- package/examples/vite-wallet/src/canisters/ledger.envelope.json +451 -0
- package/examples/vite-wallet/src/canisters/ledger.ts +56 -0
- package/examples/vite-wallet/src/client.ts +45 -0
- package/examples/vite-wallet/src/main.tsx +18 -0
- package/examples/vite-wallet/src/optimistic-contacts.ts +113 -0
- package/examples/vite-wallet/src/refusal.ts +17 -0
- package/examples/vite-wallet/src/styles.css +282 -0
- package/examples/vite-wallet/src/test/test-wallet.tsx +322 -0
- package/examples/vite-wallet/src/token.ts +50 -0
- package/examples/vite-wallet/src/transfer.test.ts +178 -0
- package/examples/vite-wallet/src/transfer.ts +110 -0
- package/examples/vite-wallet/src/use-canisters.ts +49 -0
- package/examples/vite-wallet/tsconfig.json +19 -0
- package/examples/vite-wallet/vite.config.ts +47 -0
- package/examples/vite-wallet/vitest.config.ts +17 -0
- package/package.json +9 -4
- package/packages/core/.size-limit.js +47 -0
- package/packages/core/LICENSE +21 -0
- package/packages/core/README.md +84 -0
- package/packages/core/llms.txt +610 -0
- package/packages/core/package.json +89 -0
- package/packages/core/src/call.ts +961 -0
- package/packages/core/src/canister.ts +259 -0
- package/packages/core/src/client.ts +2061 -0
- package/packages/core/src/errors.ts +1079 -0
- package/packages/core/src/hydration.ts +239 -0
- package/packages/core/src/index.ts +23 -0
- package/packages/core/src/keys.ts +108 -0
- package/packages/core/src/management.ts +138 -0
- package/packages/core/src/network.ts +1020 -0
- package/packages/core/src/options.ts +1000 -0
- package/packages/core/src/runtime.ts +50 -0
- package/packages/core/src/testing/fake-replica.ts +1166 -0
- package/packages/core/src/testing/index.ts +16 -0
- package/packages/core/src/testing/test-auth.ts +340 -0
- package/packages/core/src/testing/test-client.ts +559 -0
- package/packages/core/src/types.ts +541 -0
- package/packages/core/src/units.ts +299 -0
- package/packages/core/src/version.ts +4 -0
- package/packages/core/tests/canister-helpers.ts +187 -0
- package/packages/core/tests/canister-id.test.ts +158 -0
- package/packages/core/tests/canister-unwrap.test.ts +94 -0
- package/packages/core/tests/canister.test-d.ts +406 -0
- package/packages/core/tests/canister.test.ts +1921 -0
- package/packages/core/tests/client-account-change.test.ts +131 -0
- package/packages/core/tests/client-agents.test.ts +402 -0
- package/packages/core/tests/client-auth-network.test.ts +719 -0
- package/packages/core/tests/client-disposed.test.ts +403 -0
- package/packages/core/tests/client-helpers.ts +136 -0
- package/packages/core/tests/client-hydration.test.ts +166 -0
- package/packages/core/tests/client-pinned.test.ts +626 -0
- package/packages/core/tests/client-session.test.ts +348 -0
- package/packages/core/tests/client.test-d.ts +181 -0
- package/packages/core/tests/client.test.ts +1162 -0
- package/packages/core/tests/encode.test.ts +171 -0
- package/packages/core/tests/env-canister-id.test.ts +666 -0
- package/packages/core/tests/env-cookie-copies.test.ts +182 -0
- package/packages/core/tests/error-guard.test.ts +222 -0
- package/packages/core/tests/errors.test-d.ts +280 -0
- package/packages/core/tests/errors.test.ts +1359 -0
- package/packages/core/tests/fixtures/README.md +28 -0
- package/packages/core/tests/fixtures/accounts.did +21 -0
- package/packages/core/tests/fixtures/accounts.envelope.json +367 -0
- package/packages/core/tests/fixtures/accounts.ts +26 -0
- package/packages/core/tests/fixtures/archive.did +31 -0
- package/packages/core/tests/fixtures/archive.envelope.json +259 -0
- package/packages/core/tests/fixtures/archive.ts +55 -0
- package/packages/core/tests/fixtures/icrc1.did +88 -0
- package/packages/core/tests/fixtures/icrc1.envelope.json +840 -0
- package/packages/core/tests/fixtures/icrc1.ts +78 -0
- package/packages/core/tests/fixtures/management.did +724 -0
- package/packages/core/tests/fixtures/management.envelope.json +4455 -0
- package/packages/core/tests/fixtures/management.ts +486 -0
- package/packages/core/tests/fixtures/shapes.did +33 -0
- package/packages/core/tests/fixtures/shapes.envelope.json +440 -0
- package/packages/core/tests/fixtures/shapes.ts +56 -0
- package/packages/core/tests/fixtures/skippable.did +15 -0
- package/packages/core/tests/fixtures/skippable.envelope.json +182 -0
- package/packages/core/tests/fixtures/skippable.ts +33 -0
- package/packages/core/tests/func.test.ts +154 -0
- package/packages/core/tests/identity-attributes.test.ts +214 -0
- package/packages/core/tests/keys.test.ts +289 -0
- package/packages/core/tests/management.test.ts +206 -0
- package/packages/core/tests/network-helpers.ts +121 -0
- package/packages/core/tests/network.test-d.ts +78 -0
- package/packages/core/tests/network.test.ts +1051 -0
- package/packages/core/tests/options.test.ts +1594 -0
- package/packages/core/tests/redirect-sign-in.test.ts +393 -0
- package/packages/core/tests/resend.test-d.ts +81 -0
- package/packages/core/tests/resend.test.ts +723 -0
- package/packages/core/tests/skip.test-d.ts +125 -0
- package/packages/core/tests/testing-entry.test.ts +73 -0
- package/packages/core/tests/testing-fake-replica.test.ts +1242 -0
- package/packages/core/tests/testing-test-auth.test-d.ts +84 -0
- package/packages/core/tests/testing-test-auth.test.ts +483 -0
- package/packages/core/tests/testing-test-client.test-d.ts +184 -0
- package/packages/core/tests/testing-test-client.test.ts +1272 -0
- package/packages/core/tests/time-realm.test.ts +63 -0
- package/packages/core/tests/time.test.ts +238 -0
- package/packages/core/tests/traps/README.md +39 -0
- package/packages/core/tests/traps/anonymous-write.test.ts +145 -0
- package/packages/core/tests/traps/classification-table.test.ts +256 -0
- package/packages/core/tests/traps/err-arm.test.ts +144 -0
- package/packages/core/tests/traps/fetch-spy.ts +39 -0
- package/packages/core/tests/traps/invalidation-after-write.test.ts +178 -0
- package/packages/core/tests/traps/ledger.ts +248 -0
- package/packages/core/tests/traps/root-key-off-local.test.ts +130 -0
- package/packages/core/tests/traps/stale-data-across-users.test.ts +173 -0
- package/packages/core/tests/traps/unresolved-name.test.ts +155 -0
- package/packages/core/tests/traps/update-as-query.test.ts +244 -0
- package/packages/core/tests/traps/update-not-resent.test.ts +126 -0
- package/packages/core/tests/traps/update-resent-when-never-delivered.test.ts +159 -0
- package/packages/core/tests/traps.test-d.ts +476 -0
- package/packages/core/tests/units.test-d.ts +118 -0
- package/packages/core/tests/units.test.ts +634 -0
- package/packages/core/tsconfig.json +19 -0
- package/packages/core/tsconfig.typecheck.json +16 -0
- package/packages/core/vitest.config.ts +13 -0
- package/packages/mcp/LICENSE +21 -0
- package/packages/mcp/README.md +189 -0
- package/packages/mcp/package.json +62 -0
- package/packages/mcp/src/candid/candid-text.test.ts +455 -0
- package/packages/mcp/src/candid/candid-text.ts +501 -0
- package/packages/mcp/src/candid/contract.test.ts +398 -0
- package/packages/mcp/src/candid/formats.ts +155 -0
- package/packages/mcp/src/candid/hex.ts +29 -0
- package/packages/mcp/src/candid/json-schema.test.ts +758 -0
- package/packages/mcp/src/candid/json-schema.ts +454 -0
- package/packages/mcp/src/candid/json.test.ts +1207 -0
- package/packages/mcp/src/candid/json.ts +1053 -0
- package/packages/mcp/src/candid/schema-walk.ts +189 -0
- package/packages/mcp/src/candid/type-text.test.ts +179 -0
- package/packages/mcp/src/candid/type-text.ts +238 -0
- package/packages/mcp/src/cli.ts +134 -0
- package/packages/mcp/src/identity.ts +188 -0
- package/packages/mcp/src/interface/cache.test.ts +48 -0
- package/packages/mcp/src/interface/cache.ts +68 -0
- package/packages/mcp/src/interface/cli-cache.test.ts +150 -0
- package/packages/mcp/src/interface/cli-cache.ts +122 -0
- package/packages/mcp/src/interface/compile-worker.test.ts +246 -0
- package/packages/mcp/src/interface/compile-worker.ts +290 -0
- package/packages/mcp/src/interface/compile.test.ts +155 -0
- package/packages/mcp/src/interface/compile.ts +281 -0
- package/packages/mcp/src/interface/docs.test.ts +105 -0
- package/packages/mcp/src/interface/docs.ts +86 -0
- package/packages/mcp/src/interface/fixtures/icrc1.did +88 -0
- package/packages/mcp/src/interface/hex.ts +8 -0
- package/packages/mcp/src/interface/ids.test.ts +71 -0
- package/packages/mcp/src/interface/ids.ts +87 -0
- package/packages/mcp/src/interface/loader.test.ts +804 -0
- package/packages/mcp/src/interface/loader.ts +519 -0
- package/packages/mcp/src/interface/read-candid.test.ts +300 -0
- package/packages/mcp/src/interface/read-candid.ts +259 -0
- package/packages/mcp/src/interface/types.ts +113 -0
- package/packages/mcp/src/network.ts +122 -0
- package/packages/mcp/src/options.ts +149 -0
- package/packages/mcp/src/server/approval.ts +159 -0
- package/packages/mcp/src/server/naming.ts +43 -0
- package/packages/mcp/src/server/results.ts +102 -0
- package/packages/mcp/src/server/server.ts +797 -0
- package/packages/mcp/src/server/tools.ts +116 -0
- package/packages/mcp/src/usage.ts +40 -0
- package/packages/mcp/tests/approval.test.ts +60 -0
- package/packages/mcp/tests/identity.test.ts +234 -0
- package/packages/mcp/tests/naming.test.ts +62 -0
- package/packages/mcp/tests/options.test.ts +140 -0
- package/packages/mcp/tests/server.test.ts +997 -0
- package/packages/mcp/tsconfig.json +19 -0
- package/packages/mcp/tsconfig.typecheck.json +10 -0
- package/packages/mcp/vitest.config.ts +10 -0
- package/packages/react/LICENSE +21 -0
- package/packages/react/README.md +328 -0
- package/packages/react/llms.txt +95 -0
- package/packages/react/package.json +95 -0
- package/packages/react/src/index.tsx +678 -0
- package/packages/react/tests/abandoned-render.test.tsx +816 -0
- package/packages/react/tests/auth.test.tsx +315 -0
- package/packages/react/tests/caller-keys.test.tsx +2334 -0
- package/packages/react/tests/client-time.test.ts +40 -0
- package/packages/react/tests/entry.test.ts +52 -0
- package/packages/react/tests/helpers.tsx +291 -0
- package/packages/react/tests/hydration.test.tsx +262 -0
- package/packages/react/tests/ownership.test.tsx +260 -0
- package/packages/react/tests/provider.server.test.tsx +169 -0
- package/packages/react/tests/query-client.test.tsx +107 -0
- package/packages/react/tests/strict-mode.test.tsx +288 -0
- package/packages/react/tests/suspense.test-d.tsx +357 -0
- package/packages/react/tests/two-query-cores.test.tsx +135 -0
- package/packages/react/tests/types.test-d.tsx +63 -0
- package/packages/react/tsconfig.json +23 -0
- package/packages/react/tsconfig.test.json +8 -0
- package/packages/react/tsconfig.typecheck.json +16 -0
- package/packages/react/vitest.config.ts +39 -0
- package/packages/vite-plugin/LICENSE +21 -0
- package/packages/vite-plugin/README.md +532 -0
- package/packages/vite-plugin/package.json +76 -0
- package/packages/vite-plugin/src/describe-value.test.ts +43 -0
- package/packages/vite-plugin/src/describe-value.ts +167 -0
- package/packages/vite-plugin/src/dev-environment.test.ts +747 -0
- package/packages/vite-plugin/src/dev-environment.ts +510 -0
- package/packages/vite-plugin/src/env.ts +431 -0
- package/packages/vite-plugin/src/fetch.ts +348 -0
- package/packages/vite-plugin/src/file-identity.ts +106 -0
- package/packages/vite-plugin/src/generate.ts +691 -0
- package/packages/vite-plugin/src/index.test.ts +1243 -0
- package/packages/vite-plugin/src/index.ts +2565 -0
- package/packages/vite-plugin/src/interface.ts +339 -0
- package/packages/vite-plugin/src/local-host.ts +34 -0
- package/packages/vite-plugin/src/options.ts +641 -0
- package/packages/vite-plugin/src/principal-text.test.ts +87 -0
- package/packages/vite-plugin/src/principal-text.ts +98 -0
- package/packages/vite-plugin/tests/close.test.ts +141 -0
- package/packages/vite-plugin/tests/environment-mode.test.ts +136 -0
- package/packages/vite-plugin/tests/fake-ic.ts +214 -0
- package/packages/vite-plugin/tests/fetch-sdk.test.ts +27 -0
- package/packages/vite-plugin/tests/fetch.test.ts +1196 -0
- package/packages/vite-plugin/tests/fixtures/fake-cli/bin.js +90 -0
- package/packages/vite-plugin/tests/fixtures/fake-cli/package.json +8 -0
- package/packages/vite-plugin/tests/fixtures/icrc1.did +88 -0
- package/packages/vite-plugin/tests/generation.test.ts +1036 -0
- package/packages/vite-plugin/tests/icp-command.test.ts +194 -0
- package/packages/vite-plugin/tests/icp-timeout.test.ts +83 -0
- package/packages/vite-plugin/tests/no-process-exit.test.ts +83 -0
- package/packages/vite-plugin/tests/on-generated.test.ts +323 -0
- package/packages/vite-plugin/tests/output-collision.test.ts +329 -0
- package/packages/vite-plugin/tests/package.test.ts +62 -0
- package/packages/vite-plugin/tests/project.test.ts +2993 -0
- package/packages/vite-plugin/tests/support.ts +339 -0
- package/packages/vite-plugin/tests/timeout.test.ts +107 -0
- package/packages/vite-plugin/tsconfig.json +23 -0
- package/packages/vite-plugin/tsconfig.typecheck.json +16 -0
- package/packages/vite-plugin/vitest.config.ts +9 -0
- package/pnpm-workspace.yaml +23 -0
- package/scripts/ai-context-files.js +72 -0
- package/scripts/assemble-docs-site.mjs +485 -0
- package/scripts/assemble-docs-site.test.mjs +568 -0
- package/scripts/build-examples.js +58 -0
- package/scripts/check-ai-context.js +963 -0
- package/scripts/check-ai-context.test.mjs +811 -0
- package/scripts/check-exports.mjs +767 -0
- package/scripts/check-exports.test.mjs +1136 -0
- package/scripts/check-snippets/ambient.d.ts +428 -0
- package/scripts/check-snippets/app/generated/backend.did +7 -0
- package/scripts/check-snippets/app/generated/backend.ts +15 -0
- package/scripts/check-snippets/app/generated/icrc1.did +88 -0
- package/scripts/check-snippets/app/generated/icrc1.ts +78 -0
- package/scripts/check-snippets/app/globals.ts +26 -0
- package/scripts/check-snippets/docs/guides/App.tsx +21 -0
- package/scripts/check-snippets/docs/guides/app/providers.tsx +23 -0
- package/scripts/check-snippets/docs/guides/auth-client.ts +47 -0
- package/scripts/check-snippets/docs/guides/canisters/backend.ts +3 -0
- package/scripts/check-snippets/docs/guides/canisters/icrc1.ts +3 -0
- package/scripts/check-snippets/docs/guides/components/LedgerCard.tsx +26 -0
- package/scripts/check-snippets/docs/guides/components/shell.tsx +11 -0
- package/scripts/check-snippets/docs/guides/components/sign-in-page.tsx +29 -0
- package/scripts/check-snippets/docs/guides/components/slow-section.tsx +5 -0
- package/scripts/check-snippets/docs/guides/generated/accounts.ts +95 -0
- package/scripts/check-snippets/docs/guides/generated/ckbtc_minter.ts +40 -0
- package/scripts/check-snippets/docs/guides/generated/icp_ledger.ts +267 -0
- package/scripts/check-snippets/docs/guides/ledger.ts +10 -0
- package/scripts/check-snippets/docs/guides/server/request-client.ts +8 -0
- package/scripts/check-snippets.mjs +993 -0
- package/scripts/check-snippets.test.mjs +338 -0
- package/scripts/check-stack.mjs +501 -0
- package/scripts/check-stack.test.mjs +800 -0
- package/scripts/clean-node-modules.js +67 -0
- package/scripts/example-projects.js +58 -0
- package/scripts/export-budget.mjs +145 -0
- package/scripts/faults.json +6749 -0
- package/scripts/lib/fault-workspace.mjs +210 -0
- package/scripts/lib/io.mjs +29 -0
- package/scripts/lib/io.test.mjs +38 -0
- package/scripts/lib/markdown-fences.mjs +56 -0
- package/scripts/lib/markdown-fences.test.mjs +84 -0
- package/scripts/lib/package-exports.mjs +54 -0
- package/scripts/lib/package-exports.test.mjs +66 -0
- package/scripts/lib/release-pr-steps.mjs +47 -0
- package/scripts/release-tag.mjs +95 -0
- package/scripts/release-tag.test.mjs +278 -0
- package/scripts/release-workflow.test.mjs +98 -0
- package/scripts/release.js +167 -0
- package/scripts/release.test.mjs +347 -0
- package/scripts/removed-v3-names.js +125 -0
- package/scripts/size-app/.size-limit.js +90 -0
- package/scripts/size-app/core.js +3 -0
- package/scripts/size-app/package.json +24 -0
- package/scripts/size-app/react.js +4 -0
- package/scripts/size-app.test.mjs +73 -0
- package/scripts/sync-ai-context-versions.js +102 -0
- package/scripts/sync-example-versions.js +151 -0
- package/scripts/test-examples-published.mjs +1585 -0
- package/scripts/test-examples-published.test.mjs +1586 -0
- package/scripts/traps/any-method-vars-not-a-list.json +5 -0
- package/scripts/traps/canister-method-unknown.json +5 -0
- package/scripts/traps/client-says-who-calls-once.json +5 -0
- package/scripts/traps/client-says-who-calls.json +5 -0
- package/scripts/traps/err-only-on-canister-err.json +14 -0
- package/scripts/traps/format-units-refuses-missing-value.json +5 -0
- package/scripts/traps/format-units-refuses-number.json +5 -0
- package/scripts/traps/format-units-unknown-option.json +5 -0
- package/scripts/traps/guard-err-is-the-methods.json +5 -0
- package/scripts/traps/guard-false-keeps-every-kind.json +5 -0
- package/scripts/traps/internals-not-exported.json +9 -0
- package/scripts/traps/network-refuses-unknown-name.json +5 -0
- package/scripts/traps/never-err-has-no-type.json +5 -0
- package/scripts/traps/options-method-unknown.json +5 -0
- package/scripts/traps/options-vars-wrong-type.json +5 -0
- package/scripts/traps/parse-units-refuses-number.json +5 -0
- package/scripts/traps/parse-units-unknown-option.json +5 -0
- package/scripts/traps/principal-is-not-plain-text.json +14 -0
- package/scripts/traps/query-options-refuses-oneway.json +5 -0
- package/scripts/traps/query-options-refuses-update.json +5 -0
- package/scripts/traps/refuse-next-unknown-option.json +5 -0
- package/scripts/traps/resend-key-reads-the-methods-arg.json +5 -0
- package/scripts/traps/resend-states-its-dedupe-key.json +5 -0
- package/scripts/traps/suspense-refuses-argument-skip.json +5 -0
- package/scripts/traps/suspense-refuses-skippable-read.json +5 -0
- package/scripts/traps/suspense-refuses-vars-skip-fits.json +5 -0
- package/scripts/traps/test-handler-method-unknown.json +5 -0
- package/scripts/traps/test-handler-nat-is-bigint.json +5 -0
- package/scripts/traps/test-handler-takes-the-domain-value.json +5 -0
- package/scripts/traps/vars-of-two-arguments-are-the-tuple.json +5 -0
- package/scripts/typecheck-examples.js +122 -0
- package/scripts/verify-faults.mjs +375 -0
- package/scripts/verify-faults.test.mjs +402 -0
- package/scripts/verify-package-artifacts.mjs +590 -0
- package/scripts/verify-peer-floors.js +399 -0
- package/scripts/verify-peer-floors.test.mjs +422 -0
- package/scripts/verify-test-fails-rules.mjs +104 -0
- package/scripts/verify-test-fails-rules.test.mjs +215 -0
- package/scripts/verify-test-fails.js +371 -0
- package/scripts/verify-traps.mjs +505 -0
- package/scripts/verify-traps.test.mjs +521 -0
- package/scripts/verify-typescript-floor.js +239 -0
- package/skill-packages/ic-reactor/SKILL.md +103 -0
- package/stack.json +8 -0
- package/tsconfig.base.json +23 -0
- package/tsconfig.json +8 -0
|
@@ -0,0 +1,187 @@
|
|
|
1
|
+
import { Link } from "@tanstack/react-router"
|
|
2
|
+
import { useEffect, useMemo, useRef, type ReactElement } from "react"
|
|
3
|
+
import { callKindOf, type CallKind } from "../../calls/kinds.ts"
|
|
4
|
+
import { MethodRunner } from "../../calls/MethodRunner.tsx"
|
|
5
|
+
import { heuristicHints } from "../../forms/hints.ts"
|
|
6
|
+
import type { CanisterInterface, MethodInfo } from "../../interface/types.ts"
|
|
7
|
+
import { Badge, ModeBadge } from "../Badge.tsx"
|
|
8
|
+
import { EmptyState } from "../EmptyState.tsx"
|
|
9
|
+
import { Notice } from "../Notice.tsx"
|
|
10
|
+
import { decodeSharedArgs, readsAtOnce } from "./shared-call.ts"
|
|
11
|
+
import { registryUnits } from "./use-canister-page.ts"
|
|
12
|
+
|
|
13
|
+
export interface MethodWorkspaceProps {
|
|
14
|
+
iface: CanisterInterface
|
|
15
|
+
/** The `?method=` text, even when no such method exists. */
|
|
16
|
+
methodName: string
|
|
17
|
+
method: MethodInfo | undefined
|
|
18
|
+
/** A link's argument bytes (hex): shared, a quick read, a replay. */
|
|
19
|
+
argsHex?: string
|
|
20
|
+
/** The link asks to read at once. */
|
|
21
|
+
run: boolean
|
|
22
|
+
certified: boolean
|
|
23
|
+
/**
|
|
24
|
+
* Asked once, as the workspace mounts: whether the reader just picked this
|
|
25
|
+
* method on the page. If so and its heading is out of view or low on the
|
|
26
|
+
* screen (on a phone the list sits above the workspace), the workspace
|
|
27
|
+
* scrolls the heading up and moves focus there.
|
|
28
|
+
*/
|
|
29
|
+
wasPicked?(): boolean
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
/** Room left above a heading scrolled to, below the sticky header. */
|
|
33
|
+
const HEADING_GAP_PX = 16
|
|
34
|
+
|
|
35
|
+
/** Why a link that asks to run a method only fills its form. */
|
|
36
|
+
const NOT_RUN: Readonly<Record<CallKind["kind"], string>> = {
|
|
37
|
+
read: "A composite query has no certified path, so it is not read at once from a certified link: the form holds the link’s arguments.",
|
|
38
|
+
idempotent:
|
|
39
|
+
"The form holds the link’s arguments. An idempotent update still goes through consensus as you: links never send one, so send it yourself.",
|
|
40
|
+
update:
|
|
41
|
+
"The form holds the link’s arguments. Links never send a write: review it, then send it yourself.",
|
|
42
|
+
oneway:
|
|
43
|
+
"The form holds the link’s arguments. Links never send a write: review it, then send it yourself.",
|
|
44
|
+
call: "The form holds the link’s arguments. A query without results is called, not read at once: press Call to send it.",
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* The selected method: its heading and docs, what a shared link brought
|
|
49
|
+
* (arguments decoded from the link, or why they could not be), and the
|
|
50
|
+
* runner with its form, call, reply and errors.
|
|
51
|
+
*/
|
|
52
|
+
export function MethodWorkspace({
|
|
53
|
+
iface,
|
|
54
|
+
methodName,
|
|
55
|
+
method,
|
|
56
|
+
argsHex,
|
|
57
|
+
run,
|
|
58
|
+
certified,
|
|
59
|
+
wasPicked,
|
|
60
|
+
}: MethodWorkspaceProps): ReactElement {
|
|
61
|
+
const units = useMemo(() => registryUnits(iface.registry), [iface.registry])
|
|
62
|
+
const hints = useMemo(
|
|
63
|
+
() => heuristicHints(units === undefined ? undefined : { units }),
|
|
64
|
+
[units]
|
|
65
|
+
)
|
|
66
|
+
// Decoded on both sides from the same bytes, so the server's prefetch and
|
|
67
|
+
// the runner build the same arguments, and the same query key. Memoized:
|
|
68
|
+
// the runner gets the same initial values on every render.
|
|
69
|
+
const shared = useMemo(
|
|
70
|
+
() =>
|
|
71
|
+
method === undefined || argsHex === undefined
|
|
72
|
+
? undefined
|
|
73
|
+
: decodeSharedArgs(method, argsHex),
|
|
74
|
+
[method, argsHex]
|
|
75
|
+
)
|
|
76
|
+
|
|
77
|
+
const heading = useRef<HTMLHeadingElement>(null)
|
|
78
|
+
// Once per mount, on purpose: the page keys the workspace by method.
|
|
79
|
+
useEffect(() => {
|
|
80
|
+
const picked = wasPicked?.() === true
|
|
81
|
+
const element = heading.current
|
|
82
|
+
if (!picked || element === null) return
|
|
83
|
+
// Measured, not assumed: the sticky header wraps to two rows on a phone.
|
|
84
|
+
const header =
|
|
85
|
+
document.querySelector(".app-header")?.getBoundingClientRect().bottom ?? 0
|
|
86
|
+
// Left alone in the upper half of the screen, where the form below it
|
|
87
|
+
// shows too; moved up from anywhere else, out of view included.
|
|
88
|
+
const { top } = element.getBoundingClientRect()
|
|
89
|
+
if (top >= header && top <= window.innerHeight / 2) return
|
|
90
|
+
window.scrollTo({ top: window.scrollY + top - header - HEADING_GAP_PX })
|
|
91
|
+
element.focus({ preventScroll: true })
|
|
92
|
+
}, [])
|
|
93
|
+
|
|
94
|
+
if (method === undefined) {
|
|
95
|
+
return (
|
|
96
|
+
<EmptyState title="No such method">
|
|
97
|
+
<p>
|
|
98
|
+
This canister has no method named{" "}
|
|
99
|
+
<code className="code-inline break-all">{methodName}</code>.
|
|
100
|
+
</p>
|
|
101
|
+
<p>Pick one from the list.</p>
|
|
102
|
+
</EmptyState>
|
|
103
|
+
)
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
const initialValues = shared?.ok === true ? shared.values : undefined
|
|
107
|
+
const kind = callKindOf(iface, method)
|
|
108
|
+
const idempotent = kind.kind === "idempotent"
|
|
109
|
+
// The same rule as the route's loader, so the runner reads at once exactly
|
|
110
|
+
// what the server prefetched: a write always waits for its sender.
|
|
111
|
+
const autoRun =
|
|
112
|
+
run && initialValues !== undefined && readsAtOnce(kind, certified)
|
|
113
|
+
|
|
114
|
+
return (
|
|
115
|
+
<div className="stack-lg">
|
|
116
|
+
<header className="method-heading">
|
|
117
|
+
<div className="row">
|
|
118
|
+
<h2
|
|
119
|
+
ref={heading}
|
|
120
|
+
className="method-heading-name mono break-all"
|
|
121
|
+
tabIndex={-1}
|
|
122
|
+
>
|
|
123
|
+
{method.name}
|
|
124
|
+
</h2>
|
|
125
|
+
<ModeBadge mode={method.mode} size="lg" />
|
|
126
|
+
{idempotent && (
|
|
127
|
+
<Badge
|
|
128
|
+
tone="info"
|
|
129
|
+
size="lg"
|
|
130
|
+
title="The registry marks this update as idempotent: it is offered as a read through { update: 'idempotent' }, and still needs you signed in."
|
|
131
|
+
>
|
|
132
|
+
idempotent
|
|
133
|
+
</Badge>
|
|
134
|
+
)}
|
|
135
|
+
</div>
|
|
136
|
+
{method.doc !== undefined && method.doc !== "" && (
|
|
137
|
+
<p className="method-heading-doc text-sm muted">{method.doc}</p>
|
|
138
|
+
)}
|
|
139
|
+
</header>
|
|
140
|
+
|
|
141
|
+
{shared !== undefined && !shared.ok && (
|
|
142
|
+
<Notice tone="warn" title="The shared arguments were not used">
|
|
143
|
+
<p className="break-all">{shared.message}</p>
|
|
144
|
+
<p>The form starts from its defaults instead.</p>
|
|
145
|
+
</Notice>
|
|
146
|
+
)}
|
|
147
|
+
{shared?.ok === true && run && !autoRun && (
|
|
148
|
+
<Notice tone="info" title="Not run from the link">
|
|
149
|
+
<p>{NOT_RUN[kind.kind]}</p>
|
|
150
|
+
</Notice>
|
|
151
|
+
)}
|
|
152
|
+
{/* The same link comes from a shared URL, a quick read or a replay, so
|
|
153
|
+
it says what happened, not where it came from. */}
|
|
154
|
+
{shared?.ok === true && autoRun && (
|
|
155
|
+
<p className="text-xs muted" role="note">
|
|
156
|
+
{method.args.length === 0 ? (
|
|
157
|
+
"Read at once: it takes no arguments."
|
|
158
|
+
) : (
|
|
159
|
+
<>
|
|
160
|
+
Read at once with the link’s arguments.{" "}
|
|
161
|
+
<Link
|
|
162
|
+
to="/canister/$canisterId"
|
|
163
|
+
params={{ canisterId: iface.canisterId }}
|
|
164
|
+
search={{
|
|
165
|
+
method: method.name,
|
|
166
|
+
certified: certified ? true : undefined,
|
|
167
|
+
}}
|
|
168
|
+
>
|
|
169
|
+
Start from an empty form
|
|
170
|
+
</Link>
|
|
171
|
+
</>
|
|
172
|
+
)}
|
|
173
|
+
</p>
|
|
174
|
+
)}
|
|
175
|
+
|
|
176
|
+
<MethodRunner
|
|
177
|
+
iface={iface}
|
|
178
|
+
method={method}
|
|
179
|
+
initialValues={initialValues}
|
|
180
|
+
autoRun={autoRun}
|
|
181
|
+
certified={certified}
|
|
182
|
+
hints={hints}
|
|
183
|
+
units={units}
|
|
184
|
+
/>
|
|
185
|
+
</div>
|
|
186
|
+
)
|
|
187
|
+
}
|
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
import { serviceMethods } from "@meantjs/schema"
|
|
2
|
+
import { encodeArgs } from "@meantjs/schema/codec"
|
|
3
|
+
import { QueryClient } from "@tanstack/react-query"
|
|
4
|
+
import { describe, expect, it } from "vitest"
|
|
5
|
+
import { actor, Account } from "../../canisters/icrc1.ts"
|
|
6
|
+
import type { MethodInfo } from "../../interface/types.ts"
|
|
7
|
+
import { toHex } from "../../lib/hex.ts"
|
|
8
|
+
import {
|
|
9
|
+
decodeSharedArgs,
|
|
10
|
+
MAX_SHARED_ARGS_BYTES,
|
|
11
|
+
methodSearchSchema,
|
|
12
|
+
readsAtOnce,
|
|
13
|
+
readWithin,
|
|
14
|
+
} from "./shared-call.ts"
|
|
15
|
+
|
|
16
|
+
const methods = serviceMethods(actor)
|
|
17
|
+
|
|
18
|
+
function method(name: string): MethodInfo {
|
|
19
|
+
const found = methods.get(name)
|
|
20
|
+
if (found === undefined) throw new Error(`no ${name}`)
|
|
21
|
+
return found
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
const NNS_GOVERNANCE = "rrkah-fqaaa-aaaaa-aaaaq-cai"
|
|
25
|
+
|
|
26
|
+
function balanceArgsHex(): string {
|
|
27
|
+
const encoded = encodeArgs(
|
|
28
|
+
[Account],
|
|
29
|
+
[{ owner: NNS_GOVERNANCE, subaccount: null }]
|
|
30
|
+
)
|
|
31
|
+
if (!encoded.ok) throw new Error("does not encode")
|
|
32
|
+
return toHex(encoded.bytes)
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
describe("methodSearchSchema", () => {
|
|
36
|
+
it("reads the spellings the router's JSON parsing produces", () => {
|
|
37
|
+
expect(
|
|
38
|
+
methodSearchSchema.parse({
|
|
39
|
+
method: "icrc1_symbol",
|
|
40
|
+
args: "4449444c0000",
|
|
41
|
+
run: 1,
|
|
42
|
+
certified: "true",
|
|
43
|
+
})
|
|
44
|
+
).toEqual({
|
|
45
|
+
method: "icrc1_symbol",
|
|
46
|
+
args: "4449444c0000",
|
|
47
|
+
run: true,
|
|
48
|
+
certified: true,
|
|
49
|
+
})
|
|
50
|
+
expect(methodSearchSchema.parse({ run: false, certified: 0 })).toEqual({
|
|
51
|
+
run: false,
|
|
52
|
+
certified: false,
|
|
53
|
+
})
|
|
54
|
+
// A method named like a number arrives as a number.
|
|
55
|
+
expect(methodSearchSchema.parse({ method: 123 }).method).toBe("123")
|
|
56
|
+
})
|
|
57
|
+
|
|
58
|
+
it("drops what does not parse instead of failing the page", () => {
|
|
59
|
+
expect(
|
|
60
|
+
methodSearchSchema.parse({
|
|
61
|
+
method: "",
|
|
62
|
+
args: "4449444c000",
|
|
63
|
+
run: "yes",
|
|
64
|
+
certified: { nested: true },
|
|
65
|
+
})
|
|
66
|
+
).toEqual({})
|
|
67
|
+
expect(methodSearchSchema.parse({ args: "zz" }).args).toBeUndefined()
|
|
68
|
+
const tooLong = "00".repeat(MAX_SHARED_ARGS_BYTES + 1)
|
|
69
|
+
expect(methodSearchSchema.parse({ args: tooLong }).args).toBeUndefined()
|
|
70
|
+
})
|
|
71
|
+
})
|
|
72
|
+
|
|
73
|
+
describe("decodeSharedArgs", () => {
|
|
74
|
+
it("decodes a link's bytes into the method's argument values", () => {
|
|
75
|
+
const shared = decodeSharedArgs(
|
|
76
|
+
method("icrc1_balance_of"),
|
|
77
|
+
balanceArgsHex()
|
|
78
|
+
)
|
|
79
|
+
expect(shared).toEqual({
|
|
80
|
+
ok: true,
|
|
81
|
+
values: [{ owner: NNS_GOVERNANCE, subaccount: null }],
|
|
82
|
+
})
|
|
83
|
+
})
|
|
84
|
+
|
|
85
|
+
it("decodes the empty argument list", () => {
|
|
86
|
+
expect(decodeSharedArgs(method("icrc1_symbol"), "4449444c0000")).toEqual({
|
|
87
|
+
ok: true,
|
|
88
|
+
values: [],
|
|
89
|
+
})
|
|
90
|
+
})
|
|
91
|
+
|
|
92
|
+
it("says why bytes are unusable", () => {
|
|
93
|
+
const balance = method("icrc1_balance_of")
|
|
94
|
+
expect(decodeSharedArgs(balance, "xyz")).toMatchObject({ ok: false })
|
|
95
|
+
// Valid Candid, but no arguments where an Account is expected.
|
|
96
|
+
const empty = decodeSharedArgs(balance, "4449444c0000")
|
|
97
|
+
expect(empty.ok).toBe(false)
|
|
98
|
+
if (!empty.ok) expect(empty.message).toMatch(/do not decode/)
|
|
99
|
+
const tooLarge = decodeSharedArgs(
|
|
100
|
+
balance,
|
|
101
|
+
"00".repeat(MAX_SHARED_ARGS_BYTES + 1)
|
|
102
|
+
)
|
|
103
|
+
expect(tooLarge).toEqual({
|
|
104
|
+
ok: false,
|
|
105
|
+
message: "The arguments in the link exceed 16 KiB.",
|
|
106
|
+
})
|
|
107
|
+
})
|
|
108
|
+
})
|
|
109
|
+
|
|
110
|
+
describe("readsAtOnce", () => {
|
|
111
|
+
it("reads at once a query with results, and a composite one only uncertified", () => {
|
|
112
|
+
const query = { kind: "read", certifiable: true } as const
|
|
113
|
+
const composite = { kind: "read", certifiable: false } as const
|
|
114
|
+
expect(readsAtOnce(query, false)).toBe(true)
|
|
115
|
+
expect(readsAtOnce(query, true)).toBe(true)
|
|
116
|
+
expect(readsAtOnce(composite, false)).toBe(true)
|
|
117
|
+
expect(readsAtOnce(composite, true)).toBe(false)
|
|
118
|
+
})
|
|
119
|
+
|
|
120
|
+
it("never runs a write, an idempotent update or a query without results", () => {
|
|
121
|
+
for (const kind of ["update", "oneway", "idempotent", "call"] as const) {
|
|
122
|
+
expect(readsAtOnce({ kind }, false)).toBe(false)
|
|
123
|
+
}
|
|
124
|
+
})
|
|
125
|
+
})
|
|
126
|
+
|
|
127
|
+
describe("readWithin", () => {
|
|
128
|
+
const key = ["test", "read"] as const
|
|
129
|
+
|
|
130
|
+
it("waits for a read that settles in time", async () => {
|
|
131
|
+
const queryClient = new QueryClient()
|
|
132
|
+
await readWithin(
|
|
133
|
+
queryClient,
|
|
134
|
+
key,
|
|
135
|
+
() => queryClient.query({ queryKey: key, queryFn: async () => 42 }),
|
|
136
|
+
1_000
|
|
137
|
+
)
|
|
138
|
+
expect(queryClient.getQueryData(key)).toBe(42)
|
|
139
|
+
})
|
|
140
|
+
|
|
141
|
+
it("never throws for a failed read", async () => {
|
|
142
|
+
const queryClient = new QueryClient({
|
|
143
|
+
defaultOptions: { queries: { retry: false } },
|
|
144
|
+
})
|
|
145
|
+
await expect(
|
|
146
|
+
readWithin(
|
|
147
|
+
queryClient,
|
|
148
|
+
key,
|
|
149
|
+
() =>
|
|
150
|
+
queryClient.query({
|
|
151
|
+
queryKey: key,
|
|
152
|
+
queryFn: async () => {
|
|
153
|
+
throw new Error("rejected")
|
|
154
|
+
},
|
|
155
|
+
}),
|
|
156
|
+
1_000
|
|
157
|
+
)
|
|
158
|
+
).resolves.toBeUndefined()
|
|
159
|
+
expect(queryClient.getQueryState(key)?.status).toBe("error")
|
|
160
|
+
})
|
|
161
|
+
|
|
162
|
+
it("cancels a read still running at the deadline", async () => {
|
|
163
|
+
const queryClient = new QueryClient()
|
|
164
|
+
await readWithin(
|
|
165
|
+
queryClient,
|
|
166
|
+
key,
|
|
167
|
+
() =>
|
|
168
|
+
queryClient.query({
|
|
169
|
+
queryKey: key,
|
|
170
|
+
queryFn: ({ signal }) =>
|
|
171
|
+
new Promise<number>((resolve, reject) => {
|
|
172
|
+
const timer = setTimeout(() => resolve(1), 5_000)
|
|
173
|
+
signal.addEventListener("abort", () => {
|
|
174
|
+
clearTimeout(timer)
|
|
175
|
+
reject(signal.reason)
|
|
176
|
+
})
|
|
177
|
+
}),
|
|
178
|
+
}),
|
|
179
|
+
20
|
|
180
|
+
)
|
|
181
|
+
const state = queryClient.getQueryState(key)
|
|
182
|
+
// Not in flight, so the server never sends it half done.
|
|
183
|
+
expect(state?.fetchStatus).toBe("idle")
|
|
184
|
+
expect(state?.data).toBeUndefined()
|
|
185
|
+
})
|
|
186
|
+
})
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
import { decodeArgs } from "@meantjs/schema/codec"
|
|
2
|
+
import type { QueryClient, QueryKey } from "@tanstack/react-query"
|
|
3
|
+
import { z } from "zod"
|
|
4
|
+
import type { CallKind } from "../../calls/kinds.ts"
|
|
5
|
+
import type { MethodInfo } from "../../interface/types.ts"
|
|
6
|
+
import { fromHex } from "../../lib/hex.ts"
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* Shared links are read with up to 16 KiB of argument bytes. The links this
|
|
10
|
+
* app writes carry less (`argsFitInUrl` in calls/share.ts): a URL is a
|
|
11
|
+
* request line, and Node refuses one that long.
|
|
12
|
+
*/
|
|
13
|
+
export const MAX_SHARED_ARGS_BYTES = 16 * 1024
|
|
14
|
+
|
|
15
|
+
// The router parses each search value as JSON first, so `run=1` arrives as
|
|
16
|
+
// the number 1 and a method named `123` as a number: accept those spellings
|
|
17
|
+
// and turn them into what the page means.
|
|
18
|
+
const flag = z
|
|
19
|
+
.union([
|
|
20
|
+
z.boolean(),
|
|
21
|
+
z.literal(1),
|
|
22
|
+
z.literal(0),
|
|
23
|
+
z.literal("1"),
|
|
24
|
+
z.literal("0"),
|
|
25
|
+
z.literal("true"),
|
|
26
|
+
z.literal("false"),
|
|
27
|
+
])
|
|
28
|
+
.transform(
|
|
29
|
+
(value) =>
|
|
30
|
+
value === true || value === 1 || value === "1" || value === "true"
|
|
31
|
+
)
|
|
32
|
+
|
|
33
|
+
const methodName = z
|
|
34
|
+
.union([z.string(), z.number(), z.boolean()])
|
|
35
|
+
.transform((value) => String(value))
|
|
36
|
+
.pipe(z.string().min(1).max(1024))
|
|
37
|
+
|
|
38
|
+
const argsHex = z
|
|
39
|
+
.string()
|
|
40
|
+
.regex(/^(?:0x)?(?:[0-9a-fA-F]{2})*$/)
|
|
41
|
+
.refine(
|
|
42
|
+
(text) => text.replace(/^0x/i, "").length <= MAX_SHARED_ARGS_BYTES * 2
|
|
43
|
+
)
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* The method workspace's search params. Each falls back to "absent" when
|
|
47
|
+
* it does not parse (`.catch`), so a mangled link opens the page instead of
|
|
48
|
+
* failing it.
|
|
49
|
+
*/
|
|
50
|
+
export const methodSearchSchema = z.object({
|
|
51
|
+
method: methodName.optional().catch(undefined),
|
|
52
|
+
args: argsHex.optional().catch(undefined),
|
|
53
|
+
run: flag.optional().catch(undefined),
|
|
54
|
+
certified: flag.optional().catch(undefined),
|
|
55
|
+
})
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* Whether a link's `run` reads the method at once (and the server prefetches
|
|
59
|
+
* it): only a read as `callKindOf` decides it, a query or composite query
|
|
60
|
+
* with results, and a composite query only off the certified twin, which it
|
|
61
|
+
* does not have. Anything else opens prefilled and waits for a click: a write
|
|
62
|
+
* is never sent from a link, an idempotent update needs a signed-in caller,
|
|
63
|
+
* and a query without results is called, not cached (`queryOptions` refuses
|
|
64
|
+
* it).
|
|
65
|
+
*/
|
|
66
|
+
export function readsAtOnce(kind: CallKind, certified: boolean): boolean {
|
|
67
|
+
return kind.kind === "read" && (kind.certifiable || !certified)
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
export type SharedArgs =
|
|
71
|
+
| { readonly ok: true; readonly values: readonly unknown[] }
|
|
72
|
+
| { readonly ok: false; readonly message: string }
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* A shared link's argument bytes, decoded against the method's argument
|
|
76
|
+
* schemas: the values a form starts from. Pure and deterministic, so the
|
|
77
|
+
* server's loader and the page (on both sides) reach the same values, and so
|
|
78
|
+
* the same query key.
|
|
79
|
+
*/
|
|
80
|
+
export function decodeSharedArgs(method: MethodInfo, hex: string): SharedArgs {
|
|
81
|
+
const bytes = fromHex(hex)
|
|
82
|
+
if (bytes === undefined) {
|
|
83
|
+
return { ok: false, message: "The arguments in the link are not hex." }
|
|
84
|
+
}
|
|
85
|
+
if (bytes.length > MAX_SHARED_ARGS_BYTES) {
|
|
86
|
+
return { ok: false, message: "The arguments in the link exceed 16 KiB." }
|
|
87
|
+
}
|
|
88
|
+
const decoded = decodeArgs(method.args, bytes)
|
|
89
|
+
if (!decoded.ok) {
|
|
90
|
+
const first = decoded.issues[0]
|
|
91
|
+
return {
|
|
92
|
+
ok: false,
|
|
93
|
+
message:
|
|
94
|
+
first === undefined
|
|
95
|
+
? "The arguments in the link do not decode for this method."
|
|
96
|
+
: `The arguments in the link do not decode for this method: ${first.message} (${first.path})`,
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
return { ok: true, values: decoded.values }
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
/** How long a server render waits for a shared link's read. */
|
|
103
|
+
export const SHARED_READ_BUDGET_MS = 4_000
|
|
104
|
+
|
|
105
|
+
/**
|
|
106
|
+
* Waits for a read (`run()`, which starts it) at most `budgetMs`. Never
|
|
107
|
+
* throws. A read still running at the deadline is cancelled, so it is not
|
|
108
|
+
* sent to the browser half done: the page reads it again itself after
|
|
109
|
+
* hydrating, and shows the real error if it fails.
|
|
110
|
+
*/
|
|
111
|
+
export async function readWithin(
|
|
112
|
+
queryClient: QueryClient,
|
|
113
|
+
queryKey: QueryKey,
|
|
114
|
+
run: () => Promise<unknown>,
|
|
115
|
+
budgetMs: number
|
|
116
|
+
): Promise<void> {
|
|
117
|
+
let timer: ReturnType<typeof setTimeout> | undefined
|
|
118
|
+
const deadline = new Promise<"late">((resolve) => {
|
|
119
|
+
timer = setTimeout(() => resolve("late"), budgetMs)
|
|
120
|
+
})
|
|
121
|
+
try {
|
|
122
|
+
const outcome = await Promise.race([
|
|
123
|
+
run().then(
|
|
124
|
+
() => "settled" as const,
|
|
125
|
+
() => "settled" as const
|
|
126
|
+
),
|
|
127
|
+
deadline,
|
|
128
|
+
])
|
|
129
|
+
if (outcome === "late") await queryClient.cancelQueries({ queryKey })
|
|
130
|
+
} finally {
|
|
131
|
+
clearTimeout(timer)
|
|
132
|
+
}
|
|
133
|
+
}
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
// @vitest-environment node
|
|
2
|
+
// The method page's loader for links that ask to run a method
|
|
3
|
+
// (`?method=…&args=<hex>&run=true`): shared links, quick reads and history
|
|
4
|
+
// replays. It reads at once only what the runner reads at once, and nothing
|
|
5
|
+
// it is given can fail the page.
|
|
6
|
+
import { createTestClient } from "@ic-reactor/core/testing"
|
|
7
|
+
import { afterEach, describe, expect, it } from "vitest"
|
|
8
|
+
import { compileInterface } from "../../interface/compile.ts"
|
|
9
|
+
import { serverCli } from "../../interface/compile.server.ts"
|
|
10
|
+
import { interfaceFromPayload } from "../../interface/load.ts"
|
|
11
|
+
import type { InterfacePayload } from "../../interface/types.ts"
|
|
12
|
+
import { sha256Hex } from "../../lib/hex.ts"
|
|
13
|
+
import { Route } from "../../routes/canister.$canisterId.index.tsx"
|
|
14
|
+
|
|
15
|
+
const ID = "qoctq-giaaa-aaaaa-aaaea-cai"
|
|
16
|
+
const DID = `service : {
|
|
17
|
+
ping : () -> () query;
|
|
18
|
+
greet : (text) -> (text) query;
|
|
19
|
+
peers : () -> (vec text) composite_query;
|
|
20
|
+
bump : () -> (nat);
|
|
21
|
+
}`
|
|
22
|
+
// DIDL, an empty type table and no values: the arguments of `ping`.
|
|
23
|
+
const NO_ARGS = "4449444c0000"
|
|
24
|
+
// "DIDL", the type `text`, and the value "bob".
|
|
25
|
+
const GREET_BOB = "4449444c00017103626f62"
|
|
26
|
+
|
|
27
|
+
type Payload = Extract<InterfacePayload, { ok: true }>
|
|
28
|
+
|
|
29
|
+
async function payloadOf(did: string): Promise<Payload> {
|
|
30
|
+
const compiled = await compileInterface(serverCli, did)
|
|
31
|
+
if (!compiled.ok) throw new Error(`does not compile: ${compiled.message}`)
|
|
32
|
+
return {
|
|
33
|
+
ok: true,
|
|
34
|
+
canisterId: ID,
|
|
35
|
+
source: { kind: "metadata", certified: true, moduleHash: null },
|
|
36
|
+
did,
|
|
37
|
+
didSha256: await sha256Hex(new TextEncoder().encode(did)),
|
|
38
|
+
envelopeJson: compiled.envelopeJson,
|
|
39
|
+
docs: {},
|
|
40
|
+
fetchedAt: 0,
|
|
41
|
+
cache: "miss",
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
type Loader = (ctx: unknown) => Promise<unknown>
|
|
46
|
+
const loader = (Route.options as unknown as { loader: Loader }).loader
|
|
47
|
+
|
|
48
|
+
let test: ReturnType<typeof createTestClient> | undefined
|
|
49
|
+
afterEach(() => {
|
|
50
|
+
test?.client.dispose()
|
|
51
|
+
test = undefined
|
|
52
|
+
})
|
|
53
|
+
|
|
54
|
+
async function open(deps: {
|
|
55
|
+
method: string
|
|
56
|
+
args: string
|
|
57
|
+
certified?: boolean
|
|
58
|
+
}): Promise<{ result: unknown; methods: string[] }> {
|
|
59
|
+
const payload = await payloadOf(DID)
|
|
60
|
+
const iface = interfaceFromPayload(payload)
|
|
61
|
+
test = createTestClient({ network: "ic", signedIn: false })
|
|
62
|
+
test.mock<Record<string, (...args: never[]) => Promise<unknown>>>(
|
|
63
|
+
iface.actor,
|
|
64
|
+
ID,
|
|
65
|
+
{
|
|
66
|
+
ping: () => undefined,
|
|
67
|
+
greet: (name: string) => `hello ${name}`,
|
|
68
|
+
peers: () => [],
|
|
69
|
+
bump: () => 1n,
|
|
70
|
+
} as never
|
|
71
|
+
)
|
|
72
|
+
const { client } = test
|
|
73
|
+
const result = await loader({
|
|
74
|
+
context: { reactor: client, queryClient: client.queryClient },
|
|
75
|
+
params: { canisterId: ID },
|
|
76
|
+
deps: { run: true, certified: false, ...deps },
|
|
77
|
+
parentMatchPromise: Promise.resolve({ loaderData: { payload } }),
|
|
78
|
+
})
|
|
79
|
+
const methods = test.requests.flatMap((r) =>
|
|
80
|
+
r.endpoint === "query" || r.endpoint === "call" ? [r.methodName ?? ""] : []
|
|
81
|
+
)
|
|
82
|
+
return { result, methods }
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
describe("the method page's loader, for a link with run=true", () => {
|
|
86
|
+
it("opens a query without results without failing the page or calling it", async () => {
|
|
87
|
+
// What a history Replay of `ping` (run as a call, kept as a query) links to.
|
|
88
|
+
const { result, methods } = await open({ method: "ping", args: NO_ARGS })
|
|
89
|
+
expect(result).toBeUndefined()
|
|
90
|
+
expect(methods).toEqual([])
|
|
91
|
+
})
|
|
92
|
+
|
|
93
|
+
it("never sends an update from a link", async () => {
|
|
94
|
+
const { methods } = await open({ method: "bump", args: NO_ARGS })
|
|
95
|
+
expect(methods).toEqual([])
|
|
96
|
+
})
|
|
97
|
+
|
|
98
|
+
it("never reads a composite query certified", async () => {
|
|
99
|
+
const { methods } = await open({
|
|
100
|
+
method: "peers",
|
|
101
|
+
args: NO_ARGS,
|
|
102
|
+
certified: true,
|
|
103
|
+
})
|
|
104
|
+
expect(methods).toEqual([])
|
|
105
|
+
})
|
|
106
|
+
|
|
107
|
+
it("reads a query with results, under the key the runner asks for", async () => {
|
|
108
|
+
const { methods } = await open({ method: "greet", args: GREET_BOB })
|
|
109
|
+
expect(methods).toEqual(["greet"])
|
|
110
|
+
const cached = test?.client.queryClient
|
|
111
|
+
.getQueryCache()
|
|
112
|
+
.getAll()
|
|
113
|
+
.map((q) => q.state.data)
|
|
114
|
+
expect(cached).toEqual(["hello bob"])
|
|
115
|
+
})
|
|
116
|
+
})
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { getRouteApi } from "@tanstack/react-router"
|
|
2
|
+
import type { TokenUnits } from "../../lib/format.ts"
|
|
3
|
+
import type { RegistryEntry } from "../../lib/registry.ts"
|
|
4
|
+
import { useCanisterInterface } from "../../interface/load.ts"
|
|
5
|
+
import type {
|
|
6
|
+
CanisterInterface,
|
|
7
|
+
InterfacePayload,
|
|
8
|
+
} from "../../interface/types.ts"
|
|
9
|
+
|
|
10
|
+
const canisterRoute = getRouteApi("/canister/$canisterId")
|
|
11
|
+
|
|
12
|
+
/**
|
|
13
|
+
* The canister layout's interface, for its child pages: the payload its
|
|
14
|
+
* loader returned and the interface rebuilt from it (the same object as the
|
|
15
|
+
* layout's, memoized by the interface's hash).
|
|
16
|
+
*/
|
|
17
|
+
export function useCanisterPage(): {
|
|
18
|
+
canisterId: string
|
|
19
|
+
payload: InterfacePayload
|
|
20
|
+
iface: CanisterInterface | undefined
|
|
21
|
+
} {
|
|
22
|
+
const { canisterId } = canisterRoute.useParams()
|
|
23
|
+
const { payload } = canisterRoute.useLoaderData()
|
|
24
|
+
const iface = useCanisterInterface(payload)
|
|
25
|
+
return { canisterId, payload, iface }
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
// Bitcoin amounts on the ckBTC minter are satoshis.
|
|
29
|
+
const MINTER_UNITS: TokenUnits = { decimals: 8, symbol: "BTC" }
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* How amounts read on a typed canister: the ledger's token, or bitcoin on
|
|
33
|
+
* the minter. `undefined` for any other canister (its amounts stay raw).
|
|
34
|
+
*/
|
|
35
|
+
export function registryUnits(
|
|
36
|
+
entry: RegistryEntry | undefined
|
|
37
|
+
): TokenUnits | undefined {
|
|
38
|
+
if (entry === undefined) return undefined
|
|
39
|
+
if (entry.kind === "ckbtc-minter") return MINTER_UNITS
|
|
40
|
+
if (entry.decimals === undefined || entry.symbol === undefined) {
|
|
41
|
+
return undefined
|
|
42
|
+
}
|
|
43
|
+
return { decimals: entry.decimals, symbol: entry.symbol }
|
|
44
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { describe, expect, it } from "vitest"
|
|
2
|
+
import { pickMountsWorkspace } from "./workspace-key.ts"
|
|
3
|
+
|
|
4
|
+
describe("pickMountsWorkspace", () => {
|
|
5
|
+
it("is false for the method already open, which nothing remounts to take the flag", () => {
|
|
6
|
+
expect(
|
|
7
|
+
pickMountsWorkspace(
|
|
8
|
+
{ method: "get_neuron_info", certified: true },
|
|
9
|
+
{ method: "get_neuron_info", certified: true }
|
|
10
|
+
)
|
|
11
|
+
).toBe(false)
|
|
12
|
+
})
|
|
13
|
+
|
|
14
|
+
it("is true for another method, the overview's quick reads, or the open method from a link", () => {
|
|
15
|
+
expect(pickMountsWorkspace({ method: "a" }, { method: "b" })).toBe(true)
|
|
16
|
+
expect(
|
|
17
|
+
pickMountsWorkspace({}, { method: "icrc1_fee", args: "4449444c0000" })
|
|
18
|
+
).toBe(true)
|
|
19
|
+
// A shared link's arguments are dropped by the list's link: a new runner.
|
|
20
|
+
expect(
|
|
21
|
+
pickMountsWorkspace(
|
|
22
|
+
{ method: "a", args: "4449444c0000" },
|
|
23
|
+
{ method: "a" }
|
|
24
|
+
)
|
|
25
|
+
).toBe(true)
|
|
26
|
+
})
|
|
27
|
+
})
|