Merge pull request #110 from IntersectMBO/feat/add-required-signers-and-native-scripts-as-ref

feat/add required signers and native scripts as ref

Author: solidsnakedev

.changeset/common-ways-occur.md

@@ -0,0 +1,18 @@
+---
+"@evolution-sdk/evolution": patch
+---
+
+### Native Scripts & Multi-Sig Support
+
+- **`addSigner` operation**: Add required signers to transactions for multi-sig and script validation
+- **Native script minting**: Full support for `ScriptAll`, `ScriptAny`, `ScriptNOfK`, `InvalidBefore`, `InvalidHereafter`
+- **Reference scripts**: Use native scripts via `readFrom` instead of attaching them to transactions
+- **Multi-sig spending**: Spend from native script addresses with multi-party signing
+- **Improved fee calculation**: Accurate fee estimation for transactions with native scripts and reference scripts
+
+### API Changes
+
+- `UTxO.scriptRef` type changed from `ScriptRef` to `Script` for better type safety
+- `PayToAddressParams.scriptRef` renamed to `script` for consistency
+- Wallet `signTx` now accepts `referenceUtxos` context for native script signer detection
+- Client `signTx` auto-fetches reference UTxOs when signing transactions with reference inputs

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

@@ -43,6 +43,7 @@ parent: Modules
   - [arbitrary](#arbitrary)
 - [utilities](#utilities)
   - [countRequiredSigners](#countrequiredsigners)
+  - [extractKeyHashes](#extractkeyhashes)
 - [utils](#utils)
   - [CDDLSchema](#cddlschema)
   - [FromCBORBytes](#fromcborbytes-1)
@@ -374,6 +375,19 @@ export declare const countRequiredSigners: (script: NativeScriptVariants) => num
 
 Added in v2.0.0
 
+## extractKeyHashes
+
+Extract all key hashes from a native script.
+Recursively traverses nested scripts to find all ScriptPubKey key hashes.
+
+**Signature**
+
+```ts
+export declare const extractKeyHashes: (script: NativeScriptVariants) => ReadonlyArray<Uint8Array>
+```
+
+Added in v2.0.0
+
 # utils
 
 ## CDDLSchema

docs/content/docs/modules/core/UTxO.mdx

@@ -25,8 +25,8 @@ parent: Modules
   - [datumOptionToSDK](#datumoptiontosdk)
   - [fromSDK](#fromsdk)
   - [fromSDKArray](#fromsdkarray)
-  - [scriptRefFromSDK](#scriptreffromsdk)
-  - [scriptRefToSDKHex](#scriptreftosdkhex)
+  - [scriptFromSDK](#scriptfromsdk)
+  - [scriptToSDK](#scripttosdk)
   - [toArray](#toarray)
   - [toSDK](#tosdk)
   - [toSDKArray](#tosdkarray)
@@ -37,7 +37,6 @@ parent: Modules
   - [UTxO (class)](#utxo-class)
     - [toJSON (method)](#tojson-method)
     - [toString (method)](#tostring-method)
-    - [[Inspectable.NodeInspectSymbol] (method)](#inspectablenodeinspectsymbol-method)
     - [[Equal.symbol] (method)](#equalsymbol-method)
     - [[Hash.symbol] (method)](#hashsymbol-method)
 - [models](#models)
@@ -207,29 +206,28 @@ export declare const fromSDKArray: (
 
 Added in v2.0.0
 
-## scriptRefFromSDK
+## scriptFromSDK
 
-Convert SDK Script to Core ScriptRef.
+Convert SDK Script to Core Script.
 
 **Signature**
 
 ```ts
-export declare const scriptRefFromSDK: (
-  script: SDKScript.Script
-) => Effect.Effect<ScriptRef.ScriptRef, ParseResult.ParseError>
+export declare const scriptFromSDK: (
+  sdkScript: SDKScript.Script
+) => Effect.Effect<Script.Script, ParseResult.ParseError>
 ```
 
 Added in v2.0.0
 
-## scriptRefToSDKHex
+## scriptToSDK
 
-Convert Core ScriptRef to SDK Script type string.
-Note: We lose the script type information as ScriptRef only stores bytes.
+Convert Core Script to SDK Script.
 
 **Signature**
 
 ```ts
-export declare const scriptRefToSDKHex: (scriptRef: ScriptRef.ScriptRef) => string
+export declare const scriptToSDK: (script: Script.Script) => SDKScript.Script
 ```
 
 Added in v2.0.0
@@ -332,14 +330,6 @@ toJSON()
 toString(): string
 ```
 
-### [Inspectable.NodeInspectSymbol] (method)
-
-**Signature**
-
-```ts
-[Inspectable.NodeInspectSymbol](): unknown
-```
-
 ### [Equal.symbol] (method)
 
 **Signature**

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

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

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

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

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

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

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

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

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

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

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

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

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

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