Merge pull request #101 from IntersectMBO/feat/add-mint-builder

feat/add mint builder

Author: solidsnakedev

.changeset/nice-tips-learn.md

@@ -0,0 +1,33 @@
+---
+"@evolution-sdk/devnet": patch
+"@evolution-sdk/evolution": patch
+---
+
+### Core Module Enhancements
+
+**Mint Module**
+- Added `Mint.getByHex()` and `Mint.getAssetsByPolicyHex()` utilities for hex-based lookups
+- Fixed `Mint.insert`, `removePolicy`, `removeAsset`, and `get` to use content-based equality (`Equal.equals`) instead of reference equality for PolicyId/AssetName lookups
+
+**Fee Calculation**
+- Fixed `calculateFeeIteratively` to include mint field in fee calculation via TxContext access
+- Removed unnecessary 5000n fee buffer that caused fee overpayment
+
+**Transaction Builder**
+- Added `.mint()` method to TransactionBuilder for native token minting/burning
+- `.attachScript()` now accepts `{ script: CoreScript }` parameter format
+- Improved type safety by using Core types directly instead of SDK wrappers
+
+### Devnet Package
+
+**Test Infrastructure**
+- Added `TxBuilder.Mint.test.ts` with devnet submit tests for minting and burning
+- Updated `TxBuilder.Scripts.test.ts` to use Core types (`PlutusV2.PlutusV2`) instead of SDK format
+- Refactored `createCoreTestUtxo` helper to accept Core `Script` types directly
+- Removed unused `createTestUtxo` (SDK format) helper
+- Added `Genesis.calculateUtxosFromConfig()` for retrieving initial UTxOs from genesis config
+- Replaced all `Buffer.from().toString("hex")` with `Text.toHex()` in tests
+
+### Breaking Changes
+- `attachScript()` now requires `{ script: ... }` object format instead of passing script directly
+- Test helpers now use Core types exclusively

docs/content/docs/modules/core/Mint.mdx

@@ -19,6 +19,9 @@ parent: Modules
 - [encoding](#encoding)
   - [toCBORBytes](#tocborbytes)
   - [toCBORHex](#tocborhex)
+- [lookup](#lookup)
+  - [getAssetsByPolicyHex](#getassetsbypolicyhex)
+  - [getByHex](#getbyhex)
 - [model](#model)
   - [Mint (class)](#mint-class)
     - [toJSON (method)](#tojson-method)
@@ -42,11 +45,11 @@ parent: Modules
   - [get](#get)
   - [insert](#insert)
   - [policyCount](#policycount)
+  - [removeAsset](#removeasset)
   - [removePolicy](#removepolicy)
 - [utils](#utils)
   - [AssetMap (type alias)](#assetmap-type-alias)
   - [CDDLSchema](#cddlschema)
-  - [removeAsset](#removeasset)
 
 ---
 
@@ -134,6 +137,41 @@ export declare const toCBORHex: (mint: Mint, options?: CBOR.CodecOptions) => str
 
 Added in v2.0.0
 
+# lookup
+
+## getAssetsByPolicyHex
+
+Get the asset map for a specific policy by hex string.
+Uses content-based equality (Equal.equals) to find matching PolicyId.
+
+**Signature**
+
+```ts
+export declare const getAssetsByPolicyHex: (
+  mint: Mint,
+  policyIdHex: string
+) => Map<AssetName.AssetName, NonZeroInt64.NonZeroInt64> | undefined
+```
+
+Added in v2.0.0
+
+## getByHex
+
+Get an asset amount by policy ID hex and asset name hex strings.
+Convenience function for tests and lookups using hex strings.
+
+**Signature**
+
+```ts
+export declare const getByHex: (
+  mint: Mint,
+  policyIdHex: string,
+  assetNameHex: string
+) => NonZeroInt64.NonZeroInt64 | undefined
+```
+
+Added in v2.0.0
+
 # model
 
 ## Mint (class)
@@ -393,6 +431,7 @@ Added in v2.0.0
 ## get
 
 Get the amount for a specific policy and asset.
+Uses content-based equality (Equal.equals) to find matching PolicyId and AssetName.
 
 **Signature**
 
@@ -409,6 +448,8 @@ Added in v2.0.0
 ## insert
 
 Add or update an asset in the Mint.
+Uses content-based equality (Equal.equals) to find matching PolicyId and AssetName
+since JavaScript Maps use reference equality by default.
 
 **Signature**
 
@@ -435,9 +476,23 @@ export declare const policyCount: (mint: Mint) => number
 
 Added in v2.0.0
 
-## removePolicy
+## removeAsset
 
 Remove an asset from the Mint.
+Uses content-based equality (Equal.equals) to find matching PolicyId and AssetName.
+
+**Signature**
+
+```ts
+export declare const removeAsset: (mint: Mint, policyId: PolicyId.PolicyId, assetName: AssetName.AssetName) => Mint
+```
+
+Added in v2.0.0
+
+## removePolicy
+
+Remove a policy from the Mint.
+Uses content-based equality (Equal.equals) to find matching PolicyId.
 
 **Signature**
 
@@ -467,11 +522,3 @@ export declare const CDDLSchema: Schema.MapFromSelf<
   Schema.MapFromSelf<typeof Schema.Uint8ArrayFromSelf, typeof Schema.BigIntFromSelf>
 >
 ```
-
-## removeAsset
-
-**Signature**
-
-```ts
-export declare const removeAsset: (mint: Mint, policyId: PolicyId.PolicyId, assetName: AssetName.AssetName) => Mint
-```

docs/content/docs/modules/core/NativeScripts.mdx

@@ -41,6 +41,8 @@ parent: Modules
   - [NativeScriptVariants](#nativescriptvariants)
 - [testing](#testing)
   - [arbitrary](#arbitrary)
+- [utilities](#utilities)
+  - [countRequiredSigners](#countrequiredsigners)
 - [utils](#utils)
   - [CDDLSchema](#cddlschema)
   - [FromCBORBytes](#fromcborbytes-1)
@@ -349,6 +351,29 @@ export declare const arbitrary: FastCheck.Arbitrary<NativeScript>
 
 Added in v2.0.0
 
+# utilities
+
+## countRequiredSigners
+
+Count the maximum number of key hashes (signers) required to satisfy a native script.
+This is used for fee calculation to ensure the fake witness set has the correct size.
+
+Algorithm:
+
+- ScriptPubKey: 1 signer required
+- ScriptAll: sum of all nested scripts (all must be satisfied)
+- ScriptAny: maximum of nested scripts (pessimistic - assume most expensive path)
+- ScriptNOfK: sum of top N most expensive nested scripts
+- InvalidBefore/InvalidHereafter: 0 signers (time-based only)
+
+**Signature**
+
+```ts
+export declare const countRequiredSigners: (script: NativeScriptVariants) => number
+```
+
+Added in v2.0.0
+
 # utils
 
 ## CDDLSchema

docs/content/docs/modules/sdk/Credential.mdx

@@ -1,6 +1,6 @@
 ---
 title: sdk/Credential.ts
-nav_order: 175
+nav_order: 176
 parent: Modules
 ---
 

docs/content/docs/modules/sdk/Datum.mdx

@@ -1,6 +1,6 @@
 ---
 title: sdk/Datum.ts
-nav_order: 176
+nav_order: 177
 parent: Modules
 ---
 

docs/content/docs/modules/sdk/Delegation.mdx

@@ -1,6 +1,6 @@
 ---
 title: sdk/Delegation.ts
-nav_order: 177
+nav_order: 178
 parent: Modules
 ---
 

docs/content/docs/modules/sdk/EvalRedeemer.mdx

@@ -1,6 +1,6 @@
 ---
 title: sdk/EvalRedeemer.ts
-nav_order: 178
+nav_order: 179
 parent: Modules
 ---
 

docs/content/docs/modules/sdk/Network.mdx

@@ -1,6 +1,6 @@
 ---
 title: sdk/Network.ts
-nav_order: 179
+nav_order: 180
 parent: Modules
 ---
 

docs/content/docs/modules/sdk/OutRef.mdx

@@ -1,6 +1,6 @@
 ---
 title: sdk/OutRef.ts
-nav_order: 180
+nav_order: 181
 parent: Modules
 ---
 

docs/content/docs/modules/sdk/PolicyId.mdx

@@ -1,6 +1,6 @@
 ---
 title: sdk/PolicyId.ts
-nav_order: 181
+nav_order: 182
 parent: Modules
 ---