@kaspacom/kcc20-tx-builder 0.5.0 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (119) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.md +2 -2
  3. package/RELEASING.md +19 -14
  4. package/artifacts/ArgentKCC20.reference.json +12428 -0
  5. package/artifacts/ArgentKCC20Wrapper.placeholder.json +12455 -0
  6. package/artifacts/KCC20.placeholder.json +1447 -1973
  7. package/artifacts/KCC20FeeTicket.placeholder.json +816 -1447
  8. package/artifacts/KCC20Orderbook.placeholder.json +1 -2
  9. package/artifacts/KCC20SnapshotBootstrap.placeholder.json +101 -100
  10. package/artifacts/KCC20SnapshotController.placeholder.json +101 -100
  11. package/artifacts/KCC20Vesting.placeholder.json +427 -429
  12. package/artifacts/KCC20Wrapper.placeholder.json +733 -734
  13. package/artifacts/kcc20-snapshot-bootstrap/KCC20SnapshotBootstrap.placeholder.json +101 -100
  14. package/artifacts/kcc20-snapshot-controller/KCC20SnapshotController.placeholder.json +101 -100
  15. package/artifacts/snapshot-standards.lock.json +6 -3
  16. package/artifacts/token-profiles.json +109 -0
  17. package/artifacts/token-profiles.sha256 +1 -0
  18. package/dist/action-source-resolver.d.ts.map +1 -1
  19. package/dist/action-source-resolver.js +11 -2
  20. package/dist/action-source-resolver.js.map +1 -1
  21. package/dist/artifacts.d.ts +10 -10
  22. package/dist/artifacts.d.ts.map +1 -1
  23. package/dist/artifacts.js +10 -10
  24. package/dist/artifacts.js.map +1 -1
  25. package/dist/cjs/action-source-resolver.js +11 -2
  26. package/dist/cjs/action-source-resolver.js.map +1 -1
  27. package/dist/cjs/artifacts.d.ts +10 -10
  28. package/dist/cjs/artifacts.js +10 -10
  29. package/dist/cjs/artifacts.js.map +1 -1
  30. package/dist/cjs/engine.d.ts +10 -0
  31. package/dist/cjs/engine.js +129 -77
  32. package/dist/cjs/engine.js.map +1 -1
  33. package/dist/cjs/index.d.ts +5 -0
  34. package/dist/cjs/index.js +5 -0
  35. package/dist/cjs/index.js.map +1 -1
  36. package/dist/cjs/profile-transfer.d.ts +60 -0
  37. package/dist/cjs/profile-transfer.js +248 -0
  38. package/dist/cjs/profile-transfer.js.map +1 -0
  39. package/dist/cjs/snapshot-signerless-transactions.js +2 -5
  40. package/dist/cjs/snapshot-signerless-transactions.js.map +1 -1
  41. package/dist/cjs/snapshot-signerless.js +5 -3
  42. package/dist/cjs/snapshot-signerless.js.map +1 -1
  43. package/dist/cjs/token-authorization.d.ts +42 -0
  44. package/dist/cjs/token-authorization.js +93 -0
  45. package/dist/cjs/token-authorization.js.map +1 -0
  46. package/dist/cjs/token-profiles.d.ts +82 -0
  47. package/dist/cjs/token-profiles.generated.d.ts +3 -0
  48. package/dist/cjs/token-profiles.generated.js +114 -0
  49. package/dist/cjs/token-profiles.generated.js.map +1 -0
  50. package/dist/cjs/token-profiles.js +257 -0
  51. package/dist/cjs/token-profiles.js.map +1 -0
  52. package/dist/cjs/transfer-payload.d.ts +9 -0
  53. package/dist/cjs/transfer-payload.js +37 -0
  54. package/dist/cjs/transfer-payload.js.map +1 -0
  55. package/dist/cjs/wrapper-operation.d.ts +1 -0
  56. package/dist/cjs/wrapper-operation.js +1 -0
  57. package/dist/cjs/wrapper-operation.js.map +1 -1
  58. package/dist/engine.d.ts +10 -0
  59. package/dist/engine.d.ts.map +1 -1
  60. package/dist/engine.js +130 -78
  61. package/dist/engine.js.map +1 -1
  62. package/dist/index.d.ts +5 -0
  63. package/dist/index.d.ts.map +1 -1
  64. package/dist/index.js +5 -0
  65. package/dist/index.js.map +1 -1
  66. package/dist/profile-transfer.d.ts +61 -0
  67. package/dist/profile-transfer.d.ts.map +1 -0
  68. package/dist/profile-transfer.js +245 -0
  69. package/dist/profile-transfer.js.map +1 -0
  70. package/dist/snapshot-signerless-transactions.d.ts.map +1 -1
  71. package/dist/snapshot-signerless-transactions.js +2 -5
  72. package/dist/snapshot-signerless-transactions.js.map +1 -1
  73. package/dist/snapshot-signerless.d.ts.map +1 -1
  74. package/dist/snapshot-signerless.js +5 -3
  75. package/dist/snapshot-signerless.js.map +1 -1
  76. package/dist/token-authorization.d.ts +43 -0
  77. package/dist/token-authorization.d.ts.map +1 -0
  78. package/dist/token-authorization.js +88 -0
  79. package/dist/token-authorization.js.map +1 -0
  80. package/dist/token-profiles.d.ts +83 -0
  81. package/dist/token-profiles.d.ts.map +1 -0
  82. package/dist/token-profiles.generated.d.ts +4 -0
  83. package/dist/token-profiles.generated.d.ts.map +1 -0
  84. package/dist/token-profiles.generated.js +111 -0
  85. package/dist/token-profiles.generated.js.map +1 -0
  86. package/dist/token-profiles.js +245 -0
  87. package/dist/token-profiles.js.map +1 -0
  88. package/dist/transfer-payload.d.ts +10 -0
  89. package/dist/transfer-payload.d.ts.map +1 -0
  90. package/dist/transfer-payload.js +34 -0
  91. package/dist/transfer-payload.js.map +1 -0
  92. package/dist/wrapper-operation.d.ts +1 -0
  93. package/dist/wrapper-operation.d.ts.map +1 -1
  94. package/dist/wrapper-operation.js +1 -0
  95. package/dist/wrapper-operation.js.map +1 -1
  96. package/docs/COMPATIBILITY.json +24 -33
  97. package/docs/LAST_CALL.md +50 -0
  98. package/examples/README.md +3 -0
  99. package/examples/backend/cli.ts +2 -1
  100. package/examples/frontend/main.ts +2 -1
  101. package/examples/shared/build.ts +3 -0
  102. package/examples/shared/offline-profile.ts +27 -0
  103. package/examples/shared/recipe-fixtures.ts +3 -2
  104. package/examples/test/browser.ts +2 -2
  105. package/examples/test/build.test.ts +21 -8
  106. package/examples/test/sources.test.ts +3 -2
  107. package/package.json +2 -2
  108. package/src/action-source-resolver.ts +22 -4
  109. package/src/artifacts.ts +12 -10
  110. package/src/engine.ts +215 -105
  111. package/src/index.ts +7 -0
  112. package/src/profile-transfer.ts +425 -0
  113. package/src/snapshot-signerless-transactions.ts +7 -16
  114. package/src/snapshot-signerless.ts +5 -3
  115. package/src/token-authorization.ts +135 -0
  116. package/src/token-profiles.generated.ts +112 -0
  117. package/src/token-profiles.ts +456 -0
  118. package/src/transfer-payload.ts +45 -0
  119. package/src/wrapper-operation.ts +2 -0
package/CHANGELOG.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.6.0
4
+
5
+ - Remove manual token profile review and funded proof flags from runtime capability checks.
6
+ - Keep authenticated registry digests, artifact hashes, operation limits, and transaction validation.
7
+ - Publish one verified tarball to npmjs and GitHub Packages after a successful version bump on `main`.
8
+
3
9
  ## 0.5.0 (unreleased)
4
10
 
5
11
  - Remove the obsolete operator-controlled snapshot cancellation constant and
package/README.md CHANGED
@@ -7,7 +7,7 @@ frontend and the Node backend.
7
7
  ## Install
8
8
 
9
9
  ```sh
10
- npm install --save-exact @kaspacom/kcc20-tx-builder@0.5.0 \
10
+ npm install --save-exact @kaspacom/kcc20-tx-builder@0.6.0 \
11
11
  --registry=https://registry.npmjs.org/ \
12
12
  --@kaspacom:registry=https://registry.npmjs.org/
13
13
  ```
@@ -29,7 +29,7 @@ not bundled or initialized by this package.
29
29
 
30
30
  Public npm installation does not require a GitHub token. The explicit scoped
31
31
  registry flag overrides project settings that route `@kaspacom` to GitHub Packages.
32
- This branch prepares `0.5.0` with expanded documentation and signerless snapshot
32
+ This branch prepares `0.6.0` with expanded documentation and signerless snapshot
33
33
  builders. Pin the same exact version across wallet and server adapters. See
34
34
  [the changelog](CHANGELOG.md) for the release contents.
35
35
 
package/RELEASING.md CHANGED
@@ -12,10 +12,12 @@ are immutable, so update `package.json` before each release.
12
12
 
13
13
  ## Publishing setup
14
14
 
15
- The package is already public on npmjs at `0.2.5`. GitHub Releases trigger
16
- `.github/workflows/publish.yml`, which has independent npmjs and GitHub Packages
17
- jobs. Both jobs install dependencies, run tests, and require the release tag to
18
- match `v` plus the checked-out `package.json` version.
15
+ After a successful `main` CI run, `.github/workflows/publish.yml` compares the
16
+ package version with the first parent of the merged commit. A changed version
17
+ triggers one job that packs the package once, publishes that tarball to npmjs
18
+ and GitHub Packages, verifies both registries, then creates the matching tag
19
+ and GitHub Release. A manual workflow dispatch retries a partial upload only
20
+ when any already published version has the same tarball integrity.
19
21
 
20
22
  npmjs uses trusted OIDC publishing with provenance on Node 24. Its trusted
21
23
  publisher identifies organization `KASPACOM`, repository `kcc20-tx-builder`,
@@ -26,29 +28,29 @@ Do not add long-lived npm tokens or publish from an unreviewed checkout.
26
28
  ## Prepare a release
27
29
 
28
30
  1. Start from reviewed `main` and update the version in a release PR.
29
- 2. Run `npm ci`, `npm test`, and `npm pack --dry-run`.
31
+ 2. Run `npm ci`, `npm test`, `npm run test:examples`, and
32
+ `npm run test:snapshot:transactions` with the pinned WASM.
30
33
  3. Inspect the tarball for compiled ESM/CommonJS entry points, declarations,
31
34
  artifacts, documentation, and license. Check that no credentials or local
32
35
  wallet files are included.
33
- 4. Merge the release PR after CI and review pass.
34
- 5. Create the matching `v<version>` tag and GitHub Release from that commit.
35
- 6. Confirm both publish jobs succeed and inspect registry metadata and the
36
+ 4. Complete the funded TN10 deploy, transfer, wrap, trade, and snapshot
37
+ construction checks against the exact candidate before merging.
38
+ 5. Merge the release PR after CI and review pass. Successful `main` CI starts
39
+ publishing automatically.
40
+ 6. Confirm the publish job succeeds and inspect registry metadata and the
36
41
  package tarball before upgrading consumers.
37
42
 
38
- Creating a GitHub Release publishes the package automatically. Prepare and
39
- review the release first; do not create a release merely to test the workflow.
40
-
41
43
  ## Consumer upgrades
42
44
 
43
45
  Install the exact released version using the registry used by your CI:
44
46
 
45
47
  ```sh
46
- npm install --save-exact @kaspacom/kcc20-tx-builder@0.5.0 \
48
+ npm install --save-exact @kaspacom/kcc20-tx-builder@0.6.0 \
47
49
  --registry=https://registry.npmjs.org/ \
48
50
  --@kaspacom:registry=https://registry.npmjs.org/
49
51
  ```
50
52
 
51
- Replace `0.5.0` with the reviewed version for a later upgrade. Commit both
53
+ Replace `0.6.0` with the reviewed version for a later upgrade. Commit both
52
54
  `package.json` and `package-lock.json`. Keep frontend and backend on the same
53
55
  exact package version. Remove any `file:../kcc20-tx-builder` resolution before
54
56
  independent CI or deployment. Run package, backend, and frontend verification
@@ -90,4 +92,7 @@ consumer deployment. Record any unverified operation families explicitly.
90
92
 
91
93
  ## Snapshot release gate
92
94
 
93
- The current candidate is version `0.5.0`. Keep publication blocked until the release workflow and trusted-publisher configuration are verified for the final release revision. Run `test:snapshot:transactions` with the pinned WASM and close the snapshot artifact reproduction and funded-rehearsal gates before creating the `v0.5.0` tag.
95
+ The current candidate is version `0.6.0`. Run `test:snapshot:transactions` with
96
+ the pinned WASM and close the snapshot artifact reproduction and funded TN10
97
+ construction gates before merging the release PR. The first publish run must
98
+ confirm npm trusted publishing for this workflow.