@kassealhq/sdk 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to `@kassealhq/sdk`. The versioning rules are in [STABILITY.md](STABILITY.md).
+
+## 0.1.1
+
+Kasseal is live on Kaspa mainnet.
+
+- `API_BASE_URLS` now lists mainnet, `https://app.kasseal.com/v1`. Testnet-10 moved to
+  `https://testnet.kasseal.com/v1`; the old testnet address now serves mainnet, so update a testnet integration that
+  hard-coded it.
+- The examples and docs use the new addresses. No change to the contract builds, the builders or the API types.
+
+## 0.1.0
+
+The first public release.
+
+**Contract builds**
+
+- Bundles two frozen builds, with SHA-256 checks on every artifact at load: `v1-kasseal-mainnet-2` (mainnet) and its
+  testnet-10 build `v1-kasseal-mainnet-2-tn10`. Pool swaps of both are composable. See
+  [docs/contract-artifacts.md](docs/contract-artifacts.md).
+- Bundles the Kaspa WASM SDK (rusty-kaspa v2.1.0), checked against pinned SHA-256 values before it loads.
+
+**Entry points**
+
+- `@kassealhq/sdk`: pure logic with no side effects on import.
+- `@kassealhq/sdk/node` and `@kassealhq/sdk/web`: everything, with the WASM and the artifacts.
+
+**Features**
+
+- Quote math for the bonding curve, the pool, liquidity and slippage, matching the contracts exactly.
+- Builders for curve buys and sells, pool swaps (including swap-and-deposit, script-owned sells and two-cell
+  sells), adding and removing liquidity, fee payouts, and splitting and merging token cells.
+- Safe defaults: a buy or deposit requires a `bound` launch proof; trades can be held to the curve and pool the proof
+  names; swap-and-deposit and script sells accept only key-locked scripts unless `allowAnyScript` is set, and never a
+  pool or token program; all-in and net-out bounds include deposits and network fees; the fee rate from the API is
+  bounded.
+- Launch-proof verification (nine steps, `verifyLaunchProofJson`), and the graduation check against the public Kaspa
+  API (`graduationOnChain`).
+- Submission helpers: transaction status, a retry policy that never trades twice (its time budget pauses while a
+  wallet window is open), fee-bump replacement.
+- Wallet adapters for KasWare, Kastle and Kaspire. KasWare and Kaspire can ask the wallet to switch network
+  (`switchNetwork`), and Kaspire reconnects on page load without opening its unlock window.
+- Typed errors with stable codes.
+- API types for the public Kasseal REST API, and `createApiSources`, the builder's UTXO sources over that API.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kasseal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,194 @@
-# Temporary Holding Version
+# @kassealhq/sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The TypeScript SDK for **Kasseal**, the KCC-20 token launchpad on Kaspa L1.
+
+Every Kasseal token starts on a **bonding curve**. When the curve sells out, the token **graduates** into a
+**constant-product pool**. Anyone can add liquidity to the pool, and the pool's swaps are **composable**: a swap can
+share its transaction with other contracts, such as a router or another venue's pool. All of it runs as Kaspa
+covenants on L1. There is no bridge, no operator key and no off-chain order book.
+
+The SDK gives you:
+
+- **Quotes** that compute exactly what the contracts compute: curve buys and sells, pool swaps, liquidity, slippage.
+- **Transaction builders** for curve buys and sells, pool swaps (including composable swap-and-deposit and
+  script-owned sells), adding and removing liquidity, and fee payouts.
+- **Launch-proof verification**, so you can prove a token, its curve and its pool are genuine before you trade.
+- **Submission helpers** for the races every UTXO venue has: build on the pending tip, retry without trading twice.
+- **Wallet adapters** for KasWare, Kastle and Kaspire.
+- **API types** for the public Kasseal REST API.
+
+Version 0.1.0 is a 0.x release: see [STABILITY.md](STABILITY.md) before you depend on it.
+
+## Install
+
+```sh
+npm install @kassealhq/sdk
+```
+
+ESM only. Node 22 or later, or any modern browser through a bundler. No runtime npm dependencies.
+
+## Entry points
+
+| Import | Use it for | Side effects on import |
+|---|---|---|
+| `@kassealhq/sdk` | Pure logic: quotes, slippage, state codecs, launch-proof format, API types | None |
+| `@kassealhq/sdk/node` | Everything, in Node: builders, signing, launch-proof verification | Loads the pinned Kaspa WASM SDK and the contract artifacts, each checked against its SHA-256 first |
+| `@kassealhq/sdk/web` | Everything, in the browser | None until you call `initWeb`, which checks the WASM and the artifacts the same way |
+
+The SDK bundles rusty-kaspa's WASM SDK v2.1.0 and the compiled Kasseal contracts. Both are checked against pinned
+SHA-256 hashes when they load. On any difference the SDK refuses to start (it fails closed).
+
+Pass the network id (`'testnet-10'` or `'mainnet'`) explicitly to every call that takes one: the builder, the
+launch-proof check, the wallet adapters. The SDK has no default API URL: you always say which API you read.
+
+## Rules every integrator must follow
+
+These rules protect your users' funds. The SDK enforces most of them by default; do not turn the checks off.
+
+1. **Verify the launch proof before you trade.** Fetch `GET /tokens/{id}/launch-proof` and verify it yourself
+   (`verifyLaunchProofJson`). Trade only when the verdict is `bound`. Pass the curve id and pool id the proof names
+   to the builder (`expectedCurveId`, `expectedPoolId`): the builder then refuses any other curve or pool. Once a
+   token has graduated, also confirm the graduation transaction against the public Kaspa API (`graduationOnChain`). See
+   [docs/launch-proof.md](docs/launch-proof.md).
+2. **Identify tokens and pools by covenant id, never by ticker or address.** Tickers are not unique. Anyone can
+   create a lookalike pool from the same program under another id, and a pool's address changes with every trade.
+   The covenant id is the only identity.
+3. **Sign only your own inputs.** A built transaction lists the inputs you sign in `inputsToSign`, all with
+   `SIGHASH_ALL`. Never sign a curve or pool input, and never sign a transaction you did not build and check. Your
+   `SIGHASH_ALL` signature covers the exact curve or pool cell you spend and every output, including the one that
+   pays you.
+4. **Know what the contracts enforce on price.** On chain:
+   - A **pool buy** is refused unless it delivers at least `minTokensOut` tokens. A **pool sell** is refused unless
+     it pays at least `minOutScaled` and at least 0.1 KAS. The SDK writes your minimum there, or the exact quote if
+     you give none.
+   - A **curve buy or sell** has no minimum argument. The curve charges the exact price of the exact number of lots
+     at the state your transaction spends. A curve sell must pay at least 0.1 KAS.
+   - These minimums sit in the part of the transaction no signature covers, so whoever relays it could rewrite
+     them. That cannot change your trade: your signature fixes the state you trade against and the amount you
+     receive. If the state changed first, your transaction is refused and nothing is charged.
+   - `maxAllIn` (buys) and `minNetOut` (sells) are checked by the SDK before you sign. They include the cell
+     deposit and the network fee, which no contract checks.
+5. **Build on the latest state, pending trades included.** Every trade spends the one live curve or pool cell, so
+   trades race. The API serves the pending tip (`tip`) when trades are in flight; build on it. If a pending trade
+   you built on is dropped, yours is refused with it and nothing is charged. Rebuild on the new state.
+6. **Retry without trading twice.** If you do not know whether a submission went through, ask
+   `GET /tx/{txid}` first. If you rebuild, spend the same wallet coins (`fundingOptions.required`) or, for a sell,
+   the same token cell. The two attempts then conflict, so at most one can go through. Never rebuild on fresh
+   coins after an unclear answer.
+
+## Quickstart: quote and buy on a pool (testnet-10)
+
+```ts
+import { createApiSources, createTxBuilder, poolLegForKas, sdk, signBuiltWithKey, xOnlyKeyOfAddress, SOMPI_PER_KAS } from '@kassealhq/sdk/node';
+import { API_BASE, NETWORK, submit, waitForOutcome } from './lib/api.ts';     // examples/lib/api.ts
+import { checkLaunchProof } from './lib/proof.ts';                            // examples/lib/proof.ts
+
+const key = new (sdk().PrivateKey)(process.env.KEY!);          // a testnet-10 key, from the environment
+const address = key.toAddress(NETWORK).toString();
+const xOnly = xOnlyKeyOfAddress(address);
+
+// 1. Prove the token, its curve and its pool. Trade only on `bound`, only with the pool the proof names.
+const proof = await checkLaunchProof(tokenId, NETWORK);
+if (proof.status !== 'bound' || proof.poolId === undefined) throw new Error(`not tradable: ${proof.status}`);
+
+// 2. Build on the latest pool state. 100 KAS, in whole 0.01 KAS units.
+const sources = createApiSources({ baseUrl: API_BASE, network: NETWORK, tokenId, ownKey: Buffer.from(xOnly).toString('hex') });
+const builder = createTxBuilder({ sources, networkId: NETWORK });
+const built = await builder.buildSwap({
+  poolId: proof.poolId, expectedPoolId: proof.poolId, tokenId,
+  trader: address, traderXOnlyPubkey: xOnly,
+  side: 'kas->tok', amountIn: poolLegForKas(100n * SOMPI_PER_KAS),
+  maxAllIn: 106n * SOMPI_PER_KAS,                              // leg + 5 KAS cell deposit + network fee, at most
+  proofVerdict: 'bound',
+});
+
+// 3. Sign your own inputs, submit, follow.
+const signed = signBuiltWithKey(built, key);
+await submit(signed.txJson);
+console.log(signed.txid, (await waitForOutcome(signed.txid))?.kind);
+```
+
+The complete program, with the safe retry, is [examples/pool-buy.ts](examples/pool-buy.ts). Read-only quotes are in
+[examples/quote.ts](examples/quote.ts).
+
+## Networks
+
+| Network | Network id | API base URL | Contract build | Status |
+|---|---|---|---|---|
+| Kaspa mainnet | `mainnet` | `https://app.kasseal.com/v1` | `v1-kasseal-mainnet-2` | Live |
+| Kaspa testnet-10 | `testnet-10` | `https://testnet.kasseal.com/v1` | `v1-kasseal-mainnet-2-tn10` | Live |
+
+The testnet build mirrors the mainnet build: the same contract sources, with Kasseal's testnet wallet as the fee
+recipient. Template hashes for both are in [docs/contract-artifacts.md](docs/contract-artifacts.md).
+
+## What a trade costs
+
+| Action | Protocol fee | KAS tied up (returned later) | Network fee |
+|---|---|---|---|
+| Curve buy | 1 % of the KAS cost | 5 KAS deposit on the new token cell, returned when you sell it | About 0.025 KAS at the minimum fee rate |
+| Curve sell | 1 % of the KAS paid out | The sold cell's deposit comes back | Similar; a sell must pay at least 0.1 KAS net |
+| Pool buy | 0.30 % of the KAS leg | 5 KAS deposit on the new token cell | A fraction of a KAS |
+| Pool sell | 0.30 % of the KAS paid out | The sold cell's deposit comes back | A fraction of a KAS; at least 0.1 KAS is paid out |
+| Add liquidity | None | 5 KAS on the new LP-share cell (at least 2.5 KAS), returned on withdrawal | A fraction of a KAS |
+| Remove liquidity | None | The LP cell's deposit comes back | A fraction of a KAS; at least 0.1 KAS is paid out |
+| Fee payout (sweep) | None | None | Paid by whoever submits it; anyone can |
+
+- **Deposits.** On Kaspa every UTXO must carry some KAS. Each token cell you receive carries a 5 KAS deposit by
+  default. It is still your KAS and comes back when the cell is spent.
+- **Network fees** depend on the transaction's mass and the network's fee rate. The SDK computes the fee exactly
+  before you sign. It refuses a fee rate from the API above 20 times the network minimum, and it caps the total fee
+  of any transaction it builds. A composed transaction that trades on two pools at once measured about 0.088 KAS on
+  testnet-10.
+- **Units.** Token amounts are whole tokens (0 decimals). Curve trades are in whole lots (1,000 tokens on most
+  tokens, 10,000 on tokens launched at high KAS prices). Pool KAS legs are whole multiples of 0.01 KAS.
+
+## Browser
+
+```js
+import { initWeb, ensurePresetArtifacts, createTxBuilder } from '@kassealhq/sdk/web';
+
+await initWeb({ network: 'testnet-10' });           // fetches and checks kaspa_bg.wasm next to the module
+await ensurePresetArtifacts('standard-k180');       // a curve preset's artifacts, before building on its curve
+```
+
+`initWeb` fetches the WASM from `webWasmUrl()` (a URL next to `web.js`) unless you pass `wasm` yourself (bytes, a
+URL or a `Response`); the bytes are hashed against the pinned digest before they are instantiated. Contract
+artifacts are code-split per curve preset; pass `preload: 'all'` to load every preset up front. If your bundler
+pre-bundles dependencies (for example Vite's `optimizeDeps`), exclude this package so the WASM URL stays next to
+the module, or pass `wasm` explicitly.
+
+## Integrity
+
+- Contract artifacts: only the two builds above are bundled. `dist/artifacts/manifest.json` lists each build's
+  template hashes and the SHA-256 of every file; the same manifest is compiled into the code, and every file is
+  checked before use. A missing, altered or unlisted file is refused (`ArtifactIntegrityError`).
+- Kaspa WASM SDK: rusty-kaspa v2.1.0, unmodified. The Node build is hashed before it is loaded; the web WASM is
+  hashed before it is instantiated (`SdkIntegrityError`).
+
+## Errors
+
+Every error class the package exports carries a stable string `errorCode` (and `code`, except the wallet errors,
+whose `code` is the wallet's numeric code). Use `errorCode(err)` or `isKassealError(err, 'SLIPPAGE_OUT_OF_RANGE')`
+instead of matching messages. `ERROR_CODES` lists them all; [docs/errors.md](docs/errors.md) describes each one.
+
+## Documentation
+
+| Page | For |
+|---|---|
+| [Concepts](docs/concepts.md) | The curve, graduation, the pool, LP shares, locked liquidity, fees |
+| [Trading bots](docs/trading-bots.md) | Reading state, building, racing, retrying, rate limits |
+| [DEXs and routers](docs/dex-and-routers.md) | Composable swaps: what the pool checks, what it refuses, what you must guard |
+| [Wallets](docs/wallets.md) | Showing Kasseal tokens and signing with KasWare, Kastle and Kaspire |
+| [Explorers](docs/explorers.md) | Labelling Kasseal covenants and transactions, decoding state |
+| [Launch proof](docs/launch-proof.md) | What the proof verifies and how to run it |
+| [API](docs/api.md) | REST routes, the stream, rate limits, errors |
+| [Errors](docs/errors.md) | Every typed error and its stable code |
+| [Contract artifacts](docs/contract-artifacts.md) | The two builds, their template hashes, verifying the bundled files |
+| [Examples](examples/README.md) | Runnable programs against testnet-10 |
+
+Also: [STABILITY.md](STABILITY.md) (versioning), [SECURITY.md](SECURITY.md) (reporting a vulnerability),
+[CHANGELOG.md](CHANGELOG.md).
+
+## Licence
+
+MIT. The bundled Kaspa WASM SDK (rusty-kaspa v2.1.0) is ISC licensed; its licence ships with it.

package/SECURITY.md

@@ -0,0 +1,60 @@
+# Security policy
+
+Kasseal moves real funds on Kaspa L1. We take every report seriously and thank everyone who reports responsibly.
+
+## Reporting a vulnerability
+
+**Report privately through GitHub's private vulnerability reporting:** open the SDK's repository on GitHub, go to
+the **Security** tab and choose **Report a vulnerability**. This is the only channel for security reports. Do not
+open a public issue, post on social media or discuss it in a public channel until it is fixed.
+
+Please include:
+
+- what is affected: the SDK version, the contract build (`v1-kasseal-mainnet-2` or `v1-kasseal-mainnet-2-tn10`), the
+  API route, or the app page;
+- the steps to reproduce, or a proof of concept (testnet-10 only);
+- the impact as you understand it: whose funds, how much, under what conditions;
+- how to reach you, and whether you want to be credited.
+
+**Test on testnet-10 only.** Never test against mainnet funds, other users' funds or Kasseal's infrastructure beyond
+normal API use. Do not degrade the service for others (no load testing, no denial of service).
+
+## What happens next
+
+These are our goals, not guarantees; we will tell you in the report if we expect to miss one.
+
+| Step | Goal |
+|---|---|
+| We acknowledge your report | Within 3 business days |
+| We confirm or dispute the issue and share our assessment | Within 10 business days |
+| We fix it, or agree a timeline with you | Depends on severity; funds-at-risk issues come first |
+| We publish an advisory and credit you (if you wish) | When the fix is released |
+
+We aim to disclose publicly within 90 days of your report, and sooner when a fix ships sooner; we ask you not to
+disclose before then. If an issue is being exploited, we may disclose earlier to protect users, and we will tell you
+first.
+
+## Scope
+
+In scope:
+
+- this SDK (`@kassealhq/sdk`): quote math, transaction builders, launch-proof verification, signing and submission
+  helpers, wallet adapters;
+- the bundled contract builds and their artifacts;
+- the public Kasseal API, where a flaw could mislead an integrator into an unsafe transaction.
+
+Out of scope: the Kaspa node and consensus, third-party wallets, the public Kaspa REST API, and issues that need a
+compromised user device or key.
+
+## What we consider most serious
+
+- Anything that lets someone take value from a curve, a pool, a liquidity provider, Kasseal's treasury or a user who
+  did not sign for it.
+- A way to make the SDK build, or ask a user to sign, a transaction other than the one it showed.
+- A way to make the launch-proof verifier report `bound` for a token, curve or pool that is not genuine.
+- A way to make the SDK accept artifacts or a WASM build that do not match their pinned hashes.
+
+## Supported versions
+
+Security fixes go into the latest 0.x release. A release with a security fix is announced in the
+[CHANGELOG](CHANGELOG.md), and affected versions are marked deprecated on npm. See [STABILITY.md](STABILITY.md).

package/STABILITY.md

@@ -0,0 +1,44 @@
+# Stability and versioning
+
+`@kassealhq/sdk` follows [semantic versioning](https://semver.org). While the version is **0.x**, the rules are:
+
+| Release | May contain |
+|---|---|
+| Patch (`0.1.0` → `0.1.1`) | Bug fixes, security fixes and documentation. No change to any stable API below, and no change to the bytes of any transaction a builder produces for the same inputs, unless the old bytes were wrong |
+| Minor (`0.1.x` → `0.2.0`) | New features, and breaking changes to the API. Every breaking change is listed in the [CHANGELOG](CHANGELOG.md) with what to do |
+
+Pin a minor version (`~0.1.0`) if you want only fixes. Version 1.0.0 will freeze the public API under the usual
+semver rules.
+
+**Safety fixes come first.** If a release fixes a way your users could lose funds, we may tighten a check in a patch
+release, so that a call which used to succeed now throws. A stricter check is never loosened in a patch. Versions
+with a safety issue are marked deprecated on npm, with the reason.
+
+## What is stable in 0.x
+
+Changes to these happen only in a minor release, listed in the CHANGELOG:
+
+- **Quote math**: the results of the curve, pool, liquidity and slippage functions. They mirror the contracts
+  exactly; a contract build never changes, so for a given build the numbers never change either.
+- **Error codes**: the `code` string of every error class in [docs/errors.md](docs/errors.md). A code is never reused
+  for a different meaning.
+- **The launch-proof verdicts**: `bound`, `unverified`, `invalid`, `malformed`, and what each means.
+- **The bundled contract builds**: `v1-kasseal-mainnet-2` and `v1-kasseal-mainnet-2-tn10`, their artifacts and
+  their hashes. A new contract build is added in a minor release; a bundled build is never modified.
+- **Entry points**: `@kassealhq/sdk`, `@kassealhq/sdk/node`, `@kassealhq/sdk/web`.
+
+## What may change in a minor release
+
+- Builder parameters and result shapes (with a CHANGELOG entry and a migration note).
+- Wallet adapter details, as the wallets themselves change.
+- The pinned Kaspa WASM SDK version.
+- Helpers marked experimental in their documentation.
+
+## What the SDK does not control
+
+- **The contracts on chain.** A launched token keeps its contract build for life. New launches may move to a new
+  build; the SDK will support both, and the CHANGELOG will say so before it happens.
+- **The Kasseal API.** Its `/v1` routes are additive: new fields are not breaking, and a breaking change ships as
+  `/v2`.
+- **Kaspa itself.** Network upgrades can change fees or mass rules; such changes ship in a release as soon as they are
+  known.

package/THIRD_PARTY_NOTICES

@@ -0,0 +1,55 @@
+Third-party components bundled with @kassealhq/sdk
+===================================================
+
+1. Kaspa WASM SDK (rusty-kaspa) v2.1.0
+   Files:   dist/kaspa/nodejs/*, dist/kaspa/web/* (unmodified release builds)
+   Source:  https://github.com/kaspanet/rusty-kaspa/releases/tag/v2.1.0
+            asset kaspa-wasm32-sdk-v2.1.0.zip
+            (sha256 ba674e109ff5dd8bedc4dc2ee8a5ecdf4b600b1178a541d77888ec58310b6124,
+            measured at download; upstream publishes no checksum)
+   Licence: ISC (the full text is also in dist/kaspa/nodejs/LICENSE and dist/kaspa/web/LICENSE)
+
+   ISC License
+
+   Copyright (c) 2022-2024 Kaspa developers
+
+   Permission to use, copy, modify, and distribute this software for any
+   purpose with or without fee is hereby granted, provided that the above
+   copyright notice and this permission notice appear in all copies.
+
+   THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+   WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+   MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+   ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+   WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+   ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+2. KCC-20 reference program (argent-lang/kcc20-reference) at c8a0871
+   Files:   dist/artifacts/codec/fixtures/argent-kcc20-reference-c8a0871.json
+            (the compiled reference token program and its template hash, from
+            fixtures/public-mint/artifact.json; no source code is included)
+   Source:  https://github.com/argent-lang/kcc20-reference/tree/c8a0871
+   Licence: ISC, as declared in the project's Cargo.toml ("license = ISC").
+            No LICENSE file accompanied the copy this was taken from; the
+            licence is recorded here as the manifest declares it, pending
+            confirmation with the upstream project.
+
+   Permission to use, copy, modify, and/or distribute this software for any
+   purpose with or without fee is hereby granted, provided that the above
+   copyright notice and this permission notice appear in all copies.
+
+   THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+   WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+   MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+   ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+   WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+   ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+3. Kasseal contract artifacts (dist/artifacts/contracts/**)
+   Compiled with silverc v1.0.0 (kaspanet/silverscript, ISC). The compiler is
+   not bundled; only its output is (no contract source code is included).
+   The artifacts are provided for verification and for use with the Kasseal
+   protocol, under the same MIT terms as the rest of this package (see
+   LICENSE).

package/dist/artifacts/codec/fixtures/argent-kcc20-reference-c8a0871.json

@@ -0,0 +1,32 @@
+{
+ "_provenance": "argent-lang/kcc20-reference @ c8a0871, fixtures/public-mint/artifact.json (https://raw.githubusercontent.com/argent-lang/kcc20-reference/c8a0871/fixtures/public-mint/artifact.json), fetched 2026-10-07. Per contract: sil_abi.contracts.<name>.compiled.{bytecode,state_span,template_hash} and argent.template_plan.templates[].actor_type_handle.template.hash (the KCC-1 template VIEW hash cut at the ABI state, after the 32-byte context field).",
+ "contracts": {
+  "KCC20": {
+   "bytecode_hex": "6b200000000000000000000000000000000000000000000000000000000000000000080000000000000000200000000000000000000000000000000000000000000000000000000000000000010001002000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000006c760479c71c238763755779825197009d755d7982765897009d7c755896765e798276012097009d7c750120969d765d7982765197009d7c759d765c7982765197009d7c759d765b798276012097009d7c750120969d765a798276012097009d7c750120969d750401000000042d0f0000b9cf7600d1b99c6976d051947600a2697652a169000000000000005779787853799452a1697652799f63765b7951527993d176bf785279c90111790291009301117993945379c9011279029100930112799394011279029100930112799393bcaa02000001aa7e01207e7c7e01877e880115795f7958cd52795379c90112790291009301127993945479c901137902910093011379939401137993bc7e5f7958cd53795479c901137902910093011379939401137993029100935579c9011479029100930114799394011479930291009301137993bc7e7ed9887678c96079029100936079939460795193935279c9011179029100930111799394011179519393012093bc785279c9011179029100930111799394011179012293935379c9011279029100930112799394011279012293935893bc52795379c9011279029100930112799394011279012b93935479c9011379029100930113799394011379012b9393012093bc53795479c9011379029100930113799394011379014c93935579c9011479029100930114799394011479014c93935193bc54795579c9011479029100930114799394011479014e93935679c9011579029100930115799394011579014e93935193bc55795679c9011579029100930115799394011579015093935779c901167902910093011679939401167901509393012093bc56795779c9011679029100930116799394011679017193935879c901177902910093011779939401177901719393012093bc011179567958cd7e01117956797e01117956797e01117956797e01117956797e01117956797e557901187a75557901187a75557901187a75557901187a75557901187a75557901187a75567a75567a75567a75567a75567a75567a755e795193607a75577a75577a75577a75577a75577a75577a75577a75577a75577a756b567a6b567a6b6c6c6c687652799f63765b7951527993d176bf785279c90111790291009301117993945379c9011279029100930112799394011279029100930112799393bcaa02000001aa7e01207e7c7e01877e880115795f7958cd52795379c90112790291009301127993945479c901137902910093011379939401137993bc7e5f7958cd53795479c901137902910093011379939401137993029100935579c9011479029100930114799394011479930291009301137993bc7e7ed9887678c96079029100936079939460795193935279c9011179029100930111799394011179519393012093bc785279c9011179029100930111799394011179012293935379c9011279029100930112799394011279012293935893bc52795379c9011279029100930112799394011279012b93935479c9011379029100930113799394011379012b9393012093bc53795479c9011379029100930113799394011379014c93935579c9011479029100930114799394011479014c93935193bc54795579c9011479029100930114799394011479014e93935679c9011579029100930115799394011579014e93935193bc55795679c9011579029100930115799394011579015093935779c901167902910093011679939401167901509393012093bc56795779c9011679029100930116799394011679017193935879c901177902910093011779939401177901719393012093bc011179567958cd7e01117956797e01117956797e01117956797e01117956797e01117956797e557901187a75557901187a75557901187a75557901187a75557901187a75557901187a75567a75567a75567a75567a75567a75567a755e795193607a75577a75577a75577a75577a75577a75577a75577a75577a75577a756b567a6b567a6b6c6c6c68b9cb7651a2697653a1695b79d2b9cb9c69011b79827c755896789c69011579827c75519600a069011379005c79787853799452a1697652799f63767660797800a26978789f69785c7978012095760120937f011779876953790113797800a26978789f69785a79011579527958957658937f935b7a7557795193597a757b757b757b757b757b757b757b75727b687652799f63767660797800a26978789f69785c7978012095760120937f011779876953790113797800a26978789f69785a79011579527958957658937f935b7a7557795193597a757b757b757b757b757b757b757b75727b680000012179827c755896787853799453a1697652799f63760124797858957658937f00a2690122797851957651937f7601007e010401007ea169012279527951957651937f7601007e010301007ea1690121795379012095760120937f011a7987695679012779547958957658937f93577a7553795193557a757b757b757b75727b687652799f63760124797858957658937f00a2690122797851957651937f7601007e010401007ea169012279527951957651937f7601007e010301007ea1690121795379012095760120937f011a7987695679012779547958957658937f93577a7553795193557a757b757b757b75727b687652799f63760124797858957658937f00a2690122797851957651937f7601007e010401007ea169012279527951957651937f7601007e010301007ea1690121795379012095760120937f011a7987695679012779547958957658937f93577a7553795193557a757b757b757b75727b68537958799c69011d790051957651937f011e7951012079827c7551967f7801008763011c79011c7952797801008763765379ac6967780101876376827c75519601619c69760001207f78012001617f7876d9765779876952795479ac697575757567780102876376827c75519601629c69760001217f78012101627f7876d9765779876952795479ab697575757567780103876376827c755196519c69760051957651937f01007e76bf547902000001aa7e01207e7c7e01877e87697567780104876376827c755196009c695279d000a069670069686868686875757567780101876300011a79011c7901008763006967011c79010187635279827c755196009c69011b7900587f7b7576009f6300776867011c79010287635279011c79ac6967011c79010387635279827c7551960281009c6952790001207f775279012001407f537901400281007f527952797ed9011e798769765279ac69757567006968687c687c6801267900012095760120937f011f7987690125790051957651937f011e7987690124790051957651937f011d79876901237900012095760120937f7887690127790058957658937f01207994765379a069b900ccc2b9bea2697575756700696868012579827c7558965b799c69005b79787853799453a1697652799f63760129797858957658937f0129795279012095760120937f012979537951957651937f012979547951957651937f0129795579012095760120937f0129795679012095760120937f012879567956795679567956795679012057797e0108577958cd7e012057797e010157797e010157797e012057797e012057797e7e7e7e7e7e7eb976c902bf0f94765193bc7c7eb976c976022d8f937cbc7eaa02000001aa7e01207e7c7e01877eb95f79ccc3885d7951935f7a757777777777777777777777777777687652799f63760129797858957658937f0129795279012095760120937f012979537951957651937f012979547951957651937f0129795579012095760120937f0129795679012095760120937f012879567956795679567956795679012057797e0108577958cd7e012057797e010157797e010157797e012057797e012057797e7e7e7e7e7e7eb976c902bf0f94765193bc7c7eb976c976022d8f937cbc7eaa02000001aa7e01207e7c7e01877eb95f79ccc3885d7951935f7a757777777777777777777777777777687652799f63760129797858957658937f0129795279012095760120937f012979537951957651937f012979547951957651937f0129795579012095760120937f0129795679012095760120937f012879567956795679567956795679012057797e0108577958cd7e012057797e010157797e010157797e012057797e012057797e7e7e7e7e7e7eb976c902bf0f94765193bc7c7eb976c976022d8f937cbc7eaa02000001aa7e01207e7c7e01877eb95f79ccc3885d7951935f7a75777777777777777777777777777768757575757575757575757575757575757575757575757575757575757575757575757575757575757551677604fd3ef14a8763755779825197009d750401000000042d0f0000b9cf76d052a2697600d1b99e697600d176bf785279c9567902910093567993945379c95779029100935779939457790291009357799393bcaa02000001aa7e01207e7c7e01877e885a79547958cd52795379c9577902910093577993945479c958790291009358799394587993bc7e547958cd53795479c958790291009358799394587993029100935579c95979029100935979939459799302910093587993bc7e7ed9887678c95579029100935579939455795193935279c9567902910093567993945679519393012093bc785279c9567902910093567993945679012293935379c9577902910093577993945779012293935893bc52795379c9577902910093577993945779012b93935479c9587902910093587993945879012b9393012093bc53795479c9587902910093587993945879014c93935579c9597902910093597993945979014c93935193bc54795579c9597902910093597993945979014e93935679c95a79029100935a7993945a79014e93935193bc55795679c95a79029100935a7993945a79015093935779c95b79029100935b7993945b7901509393012093bc56795779c95b79029100935b7993945b79017193935879c95c79029100935c7993945c7901719393012093bcb9cb009c695f795f790114797801008763765379ac6967780101876376827c75519601619c69760001207f78012001617f7876d9765779876952795479ac697575757567780102876376827c75519601629c69760001217f78012101627f7876d9765779876952795479ab697575757567780103876376827c755196519c69760051957651937f01007e76bf547902000001aa7e01207e7c7e01877e87697567780104876376827c755196009c695279d000a06967006968686868687575757575757575757575757575757575757575757551676a6868",
+   "state_span": {
+    "offset": 1,
+    "len": 145
+   },
+   "template_hash": "9703112ee6e3555107cd168858992b77d3b74f655205b2b463b1f9ec2ec73cf7",
+   "view_template_hash": "734850b0af0aeef49f009167bf9ddd238fd8c5cdbe214234f97181ac6f5cc498"
+  },
+  "PublicMint": {
+   "bytecode_hex": "6b2000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000800000000000000000800000000000000002000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000006c76040fe04b098763755d7982599f69755c798201209d755b7982519d755a7982519d7559798201209d7558798201209d755779825197009d755679825197009d75b9cf76d0519c69b9cb529c69b900ccb951cc607900a06960795679a16960795779a1695b79547987695e797601007e010401007ea1695e797601007e010301007ea1695879011379945879587958795779c2b9be9c695e795e795579557955795579012056797e012056797e0108567958cd7e0108567958cd7e012056797e012056797e7e7e7e7e7eb976c902e30794765193bc7c7eb976c976024c87937cbc7eaa02000001aa7e01207e7c7e01877e5e79c388011479011d79011d79011d79011d79011d79011d79011b79011e79827c75519658cd011f797e011e79827c75519658cd011f797e7ed988012057797e0108577958cd7e012057797e010157797e010157797e012057797e012057797e7e7e7e7e7e7e011e797c7e011d797eaa02000001aa7e01207e7c7e01877e011479c3887575757575757575757575757575757575757575757575757575757575757575757575755167760452f03341876375577982599f697556798201209d75b9cf76d0519c69b9cb529c69b900ccb951cc5a7900a0695a7957795296a16956795b79945679567956795e795a795f795a795979c2b9be9c69607960795979597959795979012056797e012056797e0108567958cd7e0108567958cd7e012056797e012056797e7e7e7e7e7eb976c902e30794765193bc7c7eb976c976024c87937cbc7eaa02000001aa7e01207e7c7e01877e6079c3880116790116795b795b795b795b79012056797e012056797e0108567958cd7e0108567958cd7e012056797e012056797e7e7e7e7e7eb976c902e30794765193bc7c7eb976c976024c87937cbc7eaa02000001aa7e01207e7c7e01877e011579c388757575757575757575757575757575757575757575757575757575757575755167760435eecca687637556798201419d75b9cf76d0519c69b9cb009c695479009c6957795379ac697575757575757575516776046f52c1a98763750401000000044c070000b9cf76d0529c697600d1b99c697651d176bf785279c9567902960093567993945379c95779029600935779939457790296009357799393bcaa02000001aa7e01207e7c7e01877e885879547958cd52795379c9577902960093577993945479c958790296009358799394587993bc7e547958cd53795479c958790296009358799394587993029600935579c95979029600935979939459799302960093587993bc7e7ed9887678c95579029600935579939455795193935279c9567902960093567993945679519393012093bc785279c9567902960093567993945679012293935379c957790296009357799394577901229393012093bc52795379c9577902960093577993945779014393935479c9587902960093587993945879014393935893bc53795479c9587902960093587993945879014c93935579c9597902960093597993945979014c93935893bc54795579c9597902960093597993945979015593935679c95a79029600935a7993945a7901559393012093bc55795679c95a79029600935a7993945a79017693935779c95b79029600935b7993945b7901769393012093bcb9cb519c69b900cc5879d2b9cb9c695e7900a269547900a26953795e799c69785c7987695e795579935e795e795e795479c2b9be9c690114790114795579557955795579012056797e012056797e0108567958cd7e0108567958cd7e012056797e012056797e7e7e7e7e7eb976c902e30794765193bc7c7eb976c976024c87937cbc7eaa02000001aa7e01207e7c7e01877e5b79c38875757575757575757575757575757575757575757575757575757551677604ebe6a14787637556798201419d750401000000044c070000b9cf76d052a2697600d1b99e697600d176bf785279c9567902960093567993945379c95779029600935779939457790296009357799393bcaa02000001aa7e01207e7c7e01877e885879547958cd52795379c9577902960093577993945479c958790296009358799394587993bc7e547958cd53795479c958790296009358799394587993029600935579c95979029600935979939459799302960093587993bc7e7ed9887678c95579029600935579939455795193935279c9567902960093567993945679519393012093bc785279c9567902960093567993945679012293935379c957790296009357799394577901229393012093bc52795379c9577902960093577993945779014393935479c9587902960093587993945879014393935893bc53795479c9587902960093587993945879014c93935579c9597902960093597993945979014c93935893bc54795579c9597902960093597993945979015593935679c95a79029600935a7993945a7901559393012093bc55795679c95a79029600935a7993945a79017693935779c95b79029600935b7993945b7901769393012093bcb9cb009c6960795c79ac69757575757575757575757575757575757551676a6868686868",
+   "state_span": {
+    "offset": 1,
+    "len": 150
+   },
+   "template_hash": "14b0f06bc176b78c94f19292e409c622636f31dae6bb31ff3d4d3308a6053b49",
+   "view_template_hash": "d973624ff2cf12795a01c270c828ef7d2d27cb55fc537e59c8dc70e61b777629"
+  },
+  "TokenSeed": {
+   "bytecode_hex": "6b2000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000006c7604d1f8dfa08763755b7982599f69755a798201209d75597982519d75587982519d7557798201209d7556798201209d755579825197009d755479825197009d75b9cf76d0519c69b9cb529c69b900ccb951cc5e79009c695979547987695c797601007e010401007ea1695c797601007e010301007ea1695379c2b9be9c695379c3b9bf876958790111790111790111790111790111790111795f79011279827c75519658cd0113797e011279827c75519658cd0113797e7ed988012057797e0108577958cd7e012057797e010157797e010157797e012057797e012057797e7e7e7e7e7e7e0112797c7e0111797eaa02000001aa7e01207e7c7e01877e5a79c388757575757575757575757575757575757575757575757575516776045dc68e5087637554798201209d75b9cf76d0519c69b9cb529c69b900ccb951cc577954795379c2b9be9c695379c3b9bf87695879587953795379012054797e012054797e012054797e012054797e7e7e7eb976c9024b0594765193bc7c7eb976c97602c684937cbc7eaa02000001aa7e01207e7c7e01877e5779c388757575757575757575757575757551677604f56af4df876375040100000004c6040000b9cf76d0529c697600d1b99c697651d176bf785279c9567902840093567993945379c95779028400935779939457790284009357799393bcaa02000001aa7e01207e7c7e01877e885679547958cd52795379c9577902840093577993945479c958790284009358799394587993bc7e547958cd53795479c958790284009358799394587993028400935579c95979028400935979939459799302840093587993bc7e7ed9887678c95579028400935579939455795193935279c9567902840093567993945679519393012093bc785279c9567902840093567993945679012293935379c957790284009357799394577901229393012093bc52795379c9577902840093577993945779014393935479c958790284009358799394587901439393012093bc53795479c9587902840093587993945879016493935579c959790284009359799394597901649393012093bcb9cb519c69b900cc5679d2b9cb9c69785a79876976c2b9be9c6976c3b9bf87697575757575757575757575757551677604ebe6a14787637554798201419d75040100000004c6040000b9cf76d052a2697600d1b99e697600d176bf785279c9567902840093567993945379c95779028400935779939457790284009357799393bcaa02000001aa7e01207e7c7e01877e885679547958cd52795379c9577902840093577993945479c958790284009358799394587993bc7e547958cd53795479c958790284009358799394587993028400935579c95979028400935979939459799302840093587993bc7e7ed9887678c95579028400935579939455795193935279c9567902840093567993945679519393012093bc785279c9567902840093567993945679012293935379c957790284009357799394577901229393012093bc52795379c9577902840093577993945779014393935479c958790284009358799394587901439393012093bc53795479c9587902840093587993945879016493935579c959790284009359799394597901649393012093bcb9cb009c695c795a79ac697575757575757575757575757551676a68686868",
+   "state_span": {
+    "offset": 1,
+    "len": 132
+   },
+   "template_hash": "f79a3fccf6f87d7076662410a17e54d1531889d9b60f630f9fbb8465a384e62d",
+   "view_template_hash": "60de5b8804cd125216c2dc029d2cbbb4ead85e45281700962efa6a8d08e3a4d9"
+  }
+ }
+}