@pizzaton/ton 0.0.0-stage → 0.1.0

package/dist/contracts/catalog/index.mjs

@@ -0,0 +1,403 @@
+import { createContractDescriptor } from "../metadata.mjs";
+const CONTRACT_CATALOG = Object.freeze(Object.fromEntries([
+	{
+		id: "official/jetton",
+		version: 1,
+		family: "token",
+		readiness: "official-reference",
+		source: {
+			repositoryUrl: "https://github.com/ton-blockchain/jetton-contract",
+			commit: "d55f228edb0eb477cb4845d67e0dacc6489c6b57",
+			commitUrl: "https://github.com/ton-blockchain/jetton-contract/commit/d55f228edb0eb477cb4845d67e0dacc6489c6b57",
+			license: "MIT"
+		},
+		upgradePolicy: "admin-controlled",
+		privilegedRoles: ["jetton admin"],
+		warnings: ["The reference minter permits admin code and data upgrades; verify and govern the admin key."]
+	},
+	{
+		id: "official/nft",
+		version: 1,
+		family: "nft",
+		readiness: "official-reference",
+		source: {
+			repositoryUrl: "https://github.com/ton-blockchain/nft-contract",
+			commit: "0b493104cd547d0fd52b7e6fd3c046fc365fe3d4",
+			commitUrl: "https://github.com/ton-blockchain/nft-contract/commit/0b493104cd547d0fd52b7e6fd3c046fc365fe3d4",
+			license: "MIT"
+		},
+		upgradePolicy: "unknown",
+		privilegedRoles: ["collection owner"],
+		warnings: ["Select immutable or editable collection behavior explicitly."]
+	},
+	{
+		id: "official/vesting",
+		version: 1,
+		family: "vesting",
+		readiness: "audit-evidence",
+		source: {
+			repositoryUrl: "https://github.com/ton-blockchain/vesting-contract",
+			commit: "2a63cb96942332abf92ed8425b37645fe4f41f86",
+			commitUrl: "https://github.com/ton-blockchain/vesting-contract/commit/2a63cb96942332abf92ed8425b37645fe4f41f86",
+			license: "MIT"
+		},
+		upgradePolicy: "unknown",
+		privilegedRoles: ["vesting owner", "vesting sender"],
+		warnings: ["Audit scope and deployed artifact must match before reuse."]
+	},
+	{
+		id: "ton-raffles/nft-launchpad",
+		version: 1,
+		family: "launchpad",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/Ton-Raffles/nft_launchpad_v1",
+			commit: "983a668dae2c5fd0b71a4c8c42c47392ecf5a9bd",
+			commitUrl: "https://github.com/Ton-Raffles/nft_launchpad_v1/commit/983a668dae2c5fd0b71a4c8c42c47392ecf5a9bd",
+			license: "MIT"
+		},
+		upgradePolicy: "unknown",
+		privilegedRoles: ["sale admin", "admin signing key"],
+		warnings: ["Admin can change sale parameters, collection ownership, active state, and remaining-balance destination.", "Purchase signatures should bind the complete sale intent and replay domain."]
+	},
+	{
+		id: "ton-raffles/staking",
+		version: 1,
+		family: "staking",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/Ton-Raffles/NFT_staking_individual_awards",
+			commit: "c87ca8facddb4ade5b28064a8b3bbc599b09c8e0",
+			commitUrl: "https://github.com/Ton-Raffles/NFT_staking_individual_awards/commit/c87ca8facddb4ade5b28064a8b3bbc599b09c8e0",
+			license: "MIT"
+		},
+		upgradePolicy: "unknown",
+		privilegedRoles: ["staking admin"],
+		warnings: ["Reward accounting, item management, and admin withdrawals require review."]
+	},
+	{
+		id: "ton-raffles/nft-lending",
+		version: 1,
+		family: "lending",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/Ton-Raffles/nft_p2p_lending",
+			commit: "0f49303d2fd4fe2f2387d55d294f868f58751ccb",
+			commitUrl: "https://github.com/Ton-Raffles/nft_p2p_lending/commit/0f49303d2fd4fe2f2387d55d294f868f58751ccb",
+			license: "MIT"
+		},
+		upgradePolicy: "unknown",
+		privilegedRoles: ["offer owner", "platform"],
+		warnings: ["Collateral, liquidation, repayment, and cancellation are asynchronous flows."]
+	},
+	{
+		id: "ton-raffles/nft-sale-modern",
+		version: 1,
+		family: "sale",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/Ton-Raffles/nft_sale_modern_v1",
+			commit: "4be2729f122b4f67013a32bd11ce4a86b0d79efa",
+			commitUrl: "https://github.com/Ton-Raffles/nft_sale_modern_v1/commit/4be2729f122b4f67013a32bd11ce4a86b0d79efa",
+			license: "MIT"
+		},
+		upgradePolicy: "unknown",
+		privilegedRoles: ["sale owner"],
+		warnings: ["Fee and refund behavior must be verified against the exact source revision."]
+	},
+	{
+		id: "ton-raffles/nft-sale-jettons",
+		version: 1,
+		family: "sale",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/Ton-Raffles/nft_sale_jettons_v1",
+			commit: "d65f5348a748b0c3567fa59b7594ca0b7218f368",
+			commitUrl: "https://github.com/Ton-Raffles/nft_sale_jettons_v1/commit/d65f5348a748b0c3567fa59b7594ca0b7218f368",
+			license: "ISC"
+		},
+		upgradePolicy: "unknown",
+		privilegedRoles: ["sale owner"],
+		warnings: ["The repository README and package metadata declare different licenses."]
+	},
+	{
+		id: "ton-raffles/nft-shopping-cart",
+		version: 1,
+		family: "sale",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/Ton-Raffles/NFT_shopping_cart",
+			commit: "78b9b18de1fda2fb2360e10e6dd54877defc906f",
+			commitUrl: "https://github.com/Ton-Raffles/NFT_shopping_cart/commit/78b9b18de1fda2fb2360e10e6dd54877defc906f",
+			license: "MIT"
+		},
+		upgradePolicy: "unknown",
+		privilegedRoles: ["cart owner", "sale owner"],
+		warnings: ["Batch purchase and refund paths require full trace testing."]
+	},
+	{
+		id: "ton-raffles/scalable-airdrop",
+		version: 1,
+		family: "airdrop",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/Ton-Raffles/scalable_airdrops_with_date_start",
+			commit: "47b8fb00163af2755b413c16cd815672c5cdeae2",
+			commitUrl: "https://github.com/Ton-Raffles/scalable_airdrops_with_date_start/commit/47b8fb00163af2755b413c16cd815672c5cdeae2",
+			license: "MIT"
+		},
+		upgradePolicy: "unknown",
+		privilegedRoles: ["airdrop admin"],
+		warnings: ["The documented claim flow depends on an exotic-cell Merkle proof and two transactions."]
+	},
+	{
+		id: "ton-raffles/offchain-proofs",
+		version: 2,
+		family: "proof",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/Ton-Raffles/offchain_proofs",
+			commit: "467815bdcbb58e604d6b82e22bfb1aa16ce6282a",
+			commitUrl: "https://github.com/Ton-Raffles/offchain_proofs/commit/467815bdcbb58e604d6b82e22bfb1aa16ce6282a",
+			ref: "offchain_prooofs_v2",
+			license: "MIT"
+		},
+		upgradePolicy: "unknown",
+		privilegedRoles: ["task admin", "proof signing key"],
+		warnings: ["Claims depend on backend signatures; key custody, domain separation, and replay controls are critical."]
+	},
+	{
+		id: "ton-raffles/nft-auction",
+		version: 2,
+		family: "auction",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/Ton-Raffles/nft_auction_v2",
+			commit: "b2bc3755c79d43f6cc2b361210362d4a1672b1dd",
+			commitUrl: "https://github.com/Ton-Raffles/nft_auction_v2/commit/b2bc3755c79d43f6cc2b361210362d4a1672b1dd",
+			license: "MIT"
+		},
+		upgradePolicy: "unknown",
+		privilegedRoles: ["auction owner", "market service"],
+		warnings: ["Bid refunds, expiry, cancellation, and market service messages require adversarial testing."]
+	},
+	{
+		id: "ton-raffles/nft-swap",
+		version: 2,
+		family: "swap",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/Ton-Raffles/nft_swap_v2",
+			commit: "8e262604c56f0be2753be254772df4a3fed03882",
+			commitUrl: "https://github.com/Ton-Raffles/nft_swap_v2/commit/8e262604c56f0be2753be254772df4a3fed03882",
+			license: "MIT"
+		},
+		upgradePolicy: "unknown",
+		privilegedRoles: ["swap participants", "market service"],
+		warnings: ["Two-sided asset custody and cancellation are asynchronous and must be state-machine tested."]
+	},
+	{
+		id: "tonresistor/bonding-curve",
+		version: 1,
+		family: "launchpad",
+		readiness: "experimental",
+		source: {
+			repositoryUrl: "https://github.com/TONresistor/bonding-curve-contracts",
+			commit: "5dbb20575fde5144d00c63f9d3099c0ac71bab95",
+			commitUrl: "https://github.com/TONresistor/bonding-curve-contracts/commit/5dbb20575fde5144d00c63f9d3099c0ac71bab95",
+			license: "MIT"
+		},
+		upgradePolicy: "admin-controlled",
+		privilegedRoles: ["master admin", "treasury"],
+		warnings: ["The upstream project explicitly states that it is unaudited and not validated at production scale."]
+	},
+	{
+		id: "pizzaton/memeland",
+		version: 1,
+		family: "launchpad",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/PizzaTon/memeland-contracts",
+			commit: "a7e132be091585b80cb6ffc6b7b50c8f0bdc53a2",
+			commitUrl: "https://github.com/PizzaTon/memeland-contracts/commit/a7e132be091585b80cb6ffc6b7b50c8f0bdc53a2"
+		},
+		upgradePolicy: "admin-controlled",
+		privilegedRoles: [
+			"factory admin",
+			"coin admin",
+			"fee collector admin"
+		],
+		warnings: ["The source contains privileged code/data replacement paths and is an old Blueprint/FunC implementation."]
+	},
+	{
+		id: "pizzaton/jetton-locker",
+		version: 1,
+		family: "locker",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/PizzaTon/jetton-locker",
+			commit: "cd1574f52b413c2aea6255a08110c8fad3b5616e",
+			commitUrl: "https://github.com/PizzaTon/jetton-locker/commit/cd1574f52b413c2aea6255a08110c8fad3b5616e"
+		},
+		upgradePolicy: "admin-controlled",
+		privilegedRoles: ["locker owner", "collection upgrader"],
+		warnings: ["The upstream revision is marked work in progress and supports mutable self/child contract upgrades."]
+	},
+	{
+		id: "ton-raffles/lock",
+		version: 1,
+		family: "locker",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/Ton-Raffles/audit-raff-and-locker",
+			commit: "c14f60c6cbc3146d31648638c33ba4154306ff80",
+			commitUrl: "https://github.com/Ton-Raffles/audit-raff-and-locker/commit/c14f60c6cbc3146d31648638c33ba4154306ff80"
+		},
+		upgradePolicy: "unknown",
+		privilegedRoles: ["lock owner"],
+		warnings: ["The public audit link must be matched to the actual lock source and deployed code before reuse."],
+		audit: {
+			auditor: "Continuation Team",
+			reportUrl: "https://github.com/Ton-Raffles/audit-raff-and-locker/blob/main/tonraffles-security-assessment.pdf",
+			auditedCommits: [],
+			scope: "Audit report repository revision; the corresponding lock contract source revision is not included."
+		}
+	},
+	{
+		id: "multix/dao",
+		version: 1,
+		family: "launchpad",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/multixcrypto/dao-contract",
+			commit: "dd03da038d8eecb72141eda77e231d536e5e3cd7",
+			commitUrl: "https://github.com/multixcrypto/dao-contract/commit/dd03da038d8eecb72141eda77e231d536e5e3cd7"
+		},
+		upgradePolicy: "unknown",
+		privilegedRoles: ["contract creator", "DAO veto authority"],
+		warnings: ["The repository prohibits commercial modification; obtain and preserve the upstream license terms before deployment.", "The wrapper accepts generated Tact cells for nested sale and vesting records to preserve ABI parity."]
+	},
+	{
+		id: "jvault/staking-v2",
+		version: 2,
+		family: "staking",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/JVault-app/staking-v2",
+			commit: "f7e83860ba7138c88bf63da13884f54d04589191",
+			commitUrl: "https://github.com/JVault-app/staking-v2/commit/f7e83860ba7138c88bf63da13884f54d04589191",
+			license: "MIT"
+		},
+		upgradePolicy: "admin-controlled",
+		privilegedRoles: ["pool creator", "factory admin"],
+		warnings: ["Pool creation and staking operate on exact jetton-wallet addresses; never substitute jetton master addresses where the contract expects pool-owned wallets.", "The upstream source contains mutable factory and wallet code paths; pin the deployed code hash and govern upgrade authority."]
+	},
+	{
+		id: "jvault/vesting",
+		version: 1,
+		family: "vesting",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/JVault-app/jettons-vesting",
+			commit: "b6d80efdbbeeeda4113ebc9d08c942b543b6b6b6",
+			commitUrl: "https://github.com/JVault-app/jettons-vesting/commit/b6d80efdbbeeeda4113ebc9d08c942b543b6b6b6",
+			license: "MIT"
+		},
+		upgradePolicy: "admin-controlled",
+		privilegedRoles: ["vesting owner", "factory admin"],
+		warnings: ["Verify the factory code dictionary and every vesting schedule before deployment."]
+	},
+	{
+		id: "jvault/airdrop",
+		version: 1,
+		family: "airdrop",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/JVault-app/jettons-airdrop",
+			commit: "54edd36d242295699278b5668514dd6f2b10260d",
+			commitUrl: "https://github.com/JVault-app/jettons-airdrop/commit/54edd36d242295699278b5668514dd6f2b10260d",
+			license: "MIT"
+		},
+		upgradePolicy: "unknown",
+		privilegedRoles: ["airdrop admin", "claim-signing key"],
+		warnings: ["Claim signatures are over the exact body state; protect key custody and campaign domain separation."]
+	},
+	{
+		id: "jvault/decentralized-launchpad",
+		version: 1,
+		family: "launchpad",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/JVault-app/decentralized-launchpad",
+			commit: "83f59e126e5e885f2d7da792998a5d569c0aa944",
+			commitUrl: "https://github.com/JVault-app/decentralized-launchpad/commit/83f59e126e5e885f2d7da792998a5d569c0aa944",
+			license: "MIT"
+		},
+		upgradePolicy: "admin-controlled",
+		privilegedRoles: [
+			"sale owner",
+			"sale admin",
+			"signature authority"
+		],
+		warnings: ["Validate the complete sale signature domain, whitelist configuration, and refund path before production use."]
+	},
+	{
+		id: "jvault/floating-staking",
+		version: 1,
+		family: "staking",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/JVault-app/floating-staking-contracts",
+			commit: "51c86b4469fd99b3e2ebdff6f8cdad9fee067b4c",
+			commitUrl: "https://github.com/JVault-app/floating-staking-contracts/commit/51c86b4469fd99b3e2ebdff6f8cdad9fee067b4c",
+			license: "MIT"
+		},
+		upgradePolicy: "admin-controlled",
+		privilegedRoles: ["pool admin", "pool creator"],
+		warnings: ["The repository includes a security assessment, but production approval still requires matching deployed code hashes."]
+	},
+	{
+		id: "jvault/fixed-staking",
+		version: 1,
+		family: "staking",
+		readiness: "research-only",
+		source: {
+			repositoryUrl: "https://github.com/JVault-app/fixed-staking-contracts",
+			commit: "63cbc8137a7dca0269bcdd9089a9dcc37acbb727",
+			commitUrl: "https://github.com/JVault-app/fixed-staking-contracts/commit/63cbc8137a7dca0269bcdd9089a9dcc37acbb727",
+			license: "MIT"
+		},
+		upgradePolicy: "unknown",
+		privilegedRoles: ["pool admin", "pool creator"],
+		warnings: ["Fixed staking uses custom NFT state and reward accounting; validate all boundary timestamps and withdrawal paths."]
+	},
+	{
+		id: "hipo/liquid-staking",
+		version: 1,
+		family: "staking",
+		readiness: "official-reference",
+		source: {
+			repositoryUrl: "https://github.com/HipoFinance/contract",
+			commit: "f7ca3db515b72b0f8e3fe63ffc64ca749e9765e0",
+			commitUrl: "https://github.com/HipoFinance/contract/commit/f7ca3db515b72b0f8e3fe63ffc64ca749e9765e0",
+			license: "MIT"
+		},
+		upgradePolicy: "admin-controlled",
+		privilegedRoles: [
+			"governor",
+			"halter",
+			"treasury and parent upgrade authorities"
+		],
+		warnings: [
+			"The upstream treasury and parent support privileged upgrades; verify current authorities and deployed code hashes before production use.",
+			"The pinned upstream source is an ABI reference; it does not prove that a particular mainnet deployment matches this revision.",
+			"Mainnet addresses are published upstream; no testnet deployment is included in this integration."
+		]
+	}
+].map((descriptor) => [descriptor.id, createContractDescriptor(descriptor)])));
+function getContractDescriptor(id, version) {
+	const descriptor = CONTRACT_CATALOG[id];
+	return descriptor && (version === void 0 || descriptor.version === version) ? descriptor : void 0;
+}
+//#endregion
+export { CONTRACT_CATALOG, getContractDescriptor };

package/dist/contracts/client.d.mts

@@ -0,0 +1,18 @@
+import { Cell, Contract, ContractProvider, SendMode, Sender, TupleItem, TupleReader } from "@ton/core";
+//#region src/contracts/client.d.ts
+export interface ContractSendOptions {
+  readonly value: bigint;
+  readonly body?: Cell;
+  readonly bounce?: boolean;
+  readonly sendMode?: SendMode;
+}
+export declare class TonContractClient<TContract extends Contract> {
+  readonly contract: TContract;
+  readonly provider: ContractProvider;
+  readonly sender?: Sender | undefined;
+  constructor(contract: TContract, provider: ContractProvider, sender?: Sender | undefined);
+  get(method: string | number, args?: readonly TupleItem[]): Promise<TupleReader>;
+  send(options: ContractSendOptions): Promise<void>;
+  withSender(sender: Sender): TonContractClient<TContract>;
+}
+//#endregion

package/dist/contracts/client.mjs

@@ -0,0 +1,31 @@
+import { TonPackageError } from "../core/errors.mjs";
+import { assertTonAmount } from "../core/amount.mjs";
+//#region src/contracts/client.ts
+var TonContractClient = class TonContractClient {
+	contract;
+	provider;
+	sender;
+	constructor(contract, provider, sender) {
+		this.contract = contract;
+		this.provider = provider;
+		this.sender = sender;
+	}
+	async get(method, args = []) {
+		return (await this.provider.get(method, [...args])).stack;
+	}
+	async send(options) {
+		if (!this.sender) throw new TonPackageError("INVALID_TRANSACTION", "A sender is required for contract writes");
+		assertTonAmount(options.value, "Contract message value");
+		await this.provider.internal(this.sender, {
+			value: options.value,
+			...options.bounce === void 0 ? {} : { bounce: options.bounce },
+			...options.sendMode === void 0 ? {} : { sendMode: options.sendMode },
+			...options.body === void 0 ? {} : { body: options.body }
+		});
+	}
+	withSender(sender) {
+		return new TonContractClient(this.contract, this.provider, sender);
+	}
+};
+//#endregion
+export { TonContractClient };

package/dist/contracts/codecs.d.mts

@@ -0,0 +1,14 @@
+import { Address, Dictionary } from "@ton/core";
+//#region src/contracts/codecs.d.ts
+/** Computes the unsigned CRC-32 used by FunC/Tolk string-derived opcodes. */
+export declare function crc32(value: string | Uint8Array): number;
+/** Canonical HashmapE(267, Unit) used by whitelist and claim messages. */
+export declare function addressFlagDictionary(addresses: readonly Address[]): Dictionary<Address, boolean>;
+/** Canonical HashmapE(32, Unit) used by request-time cancellation messages. */
+export declare function uint32FlagDictionary(values: readonly number[]): Dictionary<number, boolean>;
+/** Canonical HashmapE(256, coins) used by jetton airdrop claim messages. */
+export declare function uint256CoinsDictionary(entries: readonly Readonly<{
+  readonly key: bigint;
+  readonly amount: bigint;
+}>[]): Dictionary<bigint, bigint>;
+//#endregion

package/dist/contracts/codecs.mjs

@@ -0,0 +1,61 @@
+import { Dictionary } from "@ton/core";
+//#region src/contracts/codecs.ts
+const CRC32_POLYNOMIAL = 3988292384;
+let crc32Table;
+function getCrc32Table() {
+	if (crc32Table) return crc32Table;
+	const table = /* @__PURE__ */ new Uint32Array(256);
+	for (let index = 0; index < table.length; index += 1) {
+		let value = index;
+		for (let bit = 0; bit < 8; bit += 1) value = (value & 1) === 1 ? value >>> 1 ^ CRC32_POLYNOMIAL : value >>> 1;
+		table[index] = value >>> 0;
+	}
+	crc32Table = table;
+	return table;
+}
+/** Computes the unsigned CRC-32 used by FunC/Tolk string-derived opcodes. */
+function crc32(value) {
+	const bytes = typeof value === "string" ? new TextEncoder().encode(value) : value;
+	let checksum = 4294967295;
+	const table = getCrc32Table();
+	for (const byte of bytes) {
+		const entry = table[(checksum ^ byte) & 255];
+		if (entry === void 0) throw new Error("CRC-32 table lookup failed");
+		checksum = entry ^ checksum >>> 8;
+	}
+	return (checksum ^ 4294967295) >>> 0;
+}
+const COINS_VALUE = {
+	serialize: (value, builder) => builder.storeCoins(value),
+	parse: (slice) => slice.loadCoins()
+};
+/** Canonical HashmapE(267, Unit) used by whitelist and claim messages. */
+function addressFlagDictionary(addresses) {
+	const dictionary = Dictionary.empty(Dictionary.Keys.Address(), {
+		serialize: (_value, builder) => builder.storeBit(1).endCell(),
+		parse: (slice) => slice.loadBit()
+	});
+	for (const address of addresses) dictionary.set(address, true);
+	return dictionary;
+}
+/** Canonical HashmapE(32, Unit) used by request-time cancellation messages. */
+function uint32FlagDictionary(values) {
+	const dictionary = Dictionary.empty(Dictionary.Keys.Uint(32), {
+		serialize: (_value, builder) => builder.storeBit(1).endCell(),
+		parse: (slice) => slice.loadBit()
+	});
+	for (const value of values) dictionary.set(value, true);
+	return dictionary;
+}
+/** Canonical HashmapE(256, coins) used by jetton airdrop claim messages. */
+function uint256CoinsDictionary(entries) {
+	const dictionary = Dictionary.empty(Dictionary.Keys.BigUint(256), COINS_VALUE);
+	for (const entry of entries) {
+		if (entry.key < 0n || entry.key >= 1n << 256n) throw new RangeError("key must fit in an unsigned 256-bit integer");
+		if (entry.amount < 0n || entry.amount >= 1n << 120n) throw new RangeError("amount must fit in TON coins");
+		dictionary.set(entry.key, entry.amount);
+	}
+	return dictionary;
+}
+//#endregion
+export { addressFlagDictionary, crc32, uint256CoinsDictionary, uint32FlagDictionary };

package/dist/contracts/hipo.d.mts

@@ -0,0 +1,138 @@
+import { JettonTransferInput, JettonWalletData } from "../jetton/index.mjs";
+import { ContractWrapper } from "./wrappers/base.mjs";
+import { Address, Cell, ContractProvider, Sender, TupleReader } from "@ton/core";
+//#region src/contracts/wrappers/hipo.d.ts
+/** Hipo Finance contract source revision pinned for this integration. */
+export declare const HIPO_CONTRACT_COMMIT = "f7ca3db515b72b0f8e3fe63ffc64ca749e9765e0";
+export declare const HIPO_OPCODES: {
+  readonly depositCoins: 1027039654;
+  readonly unstakeTokens: 1499400124;
+};
+export declare const HIPO_UNSTAKE_MODES: {
+  readonly auto: 0;
+  readonly instant: 1;
+  readonly best: 2;
+};
+export type HipoUnstakeMode = (typeof HIPO_UNSTAKE_MODES)[keyof typeof HIPO_UNSTAKE_MODES];
+export declare const HIPO_MAINNET_ADDRESSES: {
+  readonly treasury: "EQCLyZHP4Xe8fpchQz76O-_RmUhaVc_9BAoGyJrwJrcbz2eZ";
+  readonly parent: "EQDPdq8xjAhytYqfGSX8KcFWIReCufsB9Wdg0pLlYSO_h76w";
+  readonly hpoJetton: "EQDQEUr0LPi8m6D6F0Wrvuok7tZbAcr0yn2Y7hK291MMzMjM";
+  readonly burner: "EQDcjZDWvotoVE0X4HSdt2pR3b2sBZ4XikzSVSdPiqdQMLRK";
+};
+export interface HipoDepositInput {
+  readonly queryId?: bigint;
+  /** `null` encodes `addr_none`, which makes the sender the hGRAM owner. */
+  readonly owner?: Address | null;
+  /** Zero asks Hipo to use the attached value after its dynamic fee. */
+  readonly coins?: bigint;
+  readonly ownershipAssignedAmount?: bigint;
+  readonly referrer?: Address | null;
+}
+export interface HipoUnstakeInput {
+  readonly tokens: bigint;
+  readonly queryId?: bigint;
+  /** Hipo accepts only the wallet owner or `addr_none` for excess return. */
+  readonly returnExcess?: Address | null;
+  readonly mode?: HipoUnstakeMode;
+  readonly ownershipAssignedAmount?: bigint;
+}
+export interface HipoTreasuryFees {
+  readonly requestLoanFee: bigint;
+  readonly depositCoinsFee: bigint;
+  readonly unstakeAllTokensFee: bigint;
+}
+export interface HipoWalletFees {
+  readonly sendTokensFee: bigint;
+  readonly unstakeTokensFee: bigint;
+  readonly upgradeWalletFee: bigint;
+  readonly walletStorageFee: bigint;
+}
+export interface HipoWalletState {
+  readonly tokens: bigint;
+  /** Raw HashmapE cell; Hipo currently does not use this dictionary. */
+  readonly staking: Cell | null;
+  readonly unstaking: bigint;
+}
+/** Stable leading fields and append-only optional fields from get_treasury_state. */
+export interface HipoTreasuryState {
+  readonly totalCoins: bigint;
+  readonly totalTokens: bigint;
+  readonly totalStaking: bigint;
+  readonly totalUnstaking: bigint;
+  readonly totalBorrowersStake: bigint;
+  readonly deficit: bigint;
+  readonly parent: Address | null;
+  readonly participations: Cell | null;
+  readonly roundsImbalance: bigint;
+  readonly stopped: boolean;
+  readonly instantMint: boolean;
+  readonly loanCodes: Cell;
+  readonly previousRate: bigint;
+  readonly currentRate: bigint;
+  readonly windowDuration: bigint;
+  readonly lastSettledRound: bigint;
+  readonly halter: Address;
+  readonly governor: Address;
+  /** Raw Maybe ^Cell returned by Hipo; it may contain proposed-governor data. */
+  readonly proposedGovernor: Cell | null;
+  readonly governanceFee: bigint;
+  readonly borrowerFee: bigint;
+  readonly collectionCodes: Cell;
+  readonly billCodes: Cell;
+  readonly oldParents: Cell | null;
+  readonly midRate?: bigint;
+  readonly midRound?: bigint;
+  readonly rewardShare?: bigint;
+  readonly totalRequestFees?: bigint;
+  readonly minEfficiency?: bigint;
+  readonly minRequestStake?: bigint;
+  readonly stakeCapFloor?: bigint;
+  /** Count of future append-only tuple values this SDK does not yet decode. */
+  readonly unknownAppendValueCount: number;
+}
+export interface HipoJettonData {
+  readonly totalSupply: bigint;
+  readonly mintable: boolean;
+  readonly adminAddress: Address;
+  readonly content: Cell;
+  readonly walletCode: Cell;
+}
+/** Build Hipo's treasury deposit message from the pinned TL-B schema. */
+export declare function buildHipoDepositBody(input?: HipoDepositInput): Cell;
+/** Build the optional mode/notification payload from Hipo's integration ABI. */
+export declare function buildHipoUnstakeCustomPayload(input?: Pick<HipoUnstakeInput, "mode" | "ownershipAssignedAmount">): Cell | null;
+/** Build the Hipo-specific Jetton burn/unstake message. */
+export declare function buildHipoUnstakeBody(input: HipoUnstakeInput): Cell;
+/** Decode Hipo's stable 24-field prefix and any known append-only tail fields. */
+export declare function parseHipoTreasuryState(stack: TupleReader): HipoTreasuryState;
+/** Hipo's liquid-staking treasury. */
+export declare class HipoTreasury extends ContractWrapper {
+  private constructor();
+  static createFromAddress(address: Address): HipoTreasury;
+  static createMainnet(): HipoTreasury;
+  sendDepositCoins(provider: ContractProvider, via: Sender, input: HipoDepositInput, attachedValue: bigint): Promise<void>;
+  getTreasuryState(provider: ContractProvider): Promise<HipoTreasuryState>;
+  getTreasuryFees(provider: ContractProvider, ownershipAssignedAmount?: bigint): Promise<HipoTreasuryFees>;
+}
+/** hGRAM Jetton master/parent. */
+export declare class HipoParent extends ContractWrapper {
+  private constructor();
+  static createFromAddress(address: Address): HipoParent;
+  static createMainnet(): HipoParent;
+  getWalletAddress(provider: ContractProvider, owner: Address): Promise<Address>;
+  getJettonData(provider: ContractProvider): Promise<HipoJettonData>;
+}
+/** User hGRAM Jetton wallet; unstake messages are sent by the wallet owner. */
+export declare class HipoWallet extends ContractWrapper {
+  private readonly jettonWallet;
+  private constructor();
+  static createFromAddress(address: Address): HipoWallet;
+  getBalance(provider: ContractProvider): Promise<bigint>;
+  getWalletData(provider: ContractProvider): Promise<JettonWalletData>;
+  sendTransfer(provider: ContractProvider, via: Sender, input: JettonTransferInput, attachedValue: bigint): Promise<void>;
+  getWalletState(provider: ContractProvider): Promise<HipoWalletState>;
+  getWalletFees(provider: ContractProvider): Promise<HipoWalletFees>;
+  sendUnstakeTokens(provider: ContractProvider, via: Sender, input: HipoUnstakeInput, attachedValue: bigint): Promise<void>;
+}
+//#endregion