Merge pull request #109 from IntersectMBO/feat/add-tx-validity

feat/add tx validity

Author: solidsnakedev

.changeset/long-deer-roll.md

@@ -0,0 +1,50 @@
+---
+"@evolution-sdk/devnet": patch
+"@evolution-sdk/evolution": patch
+---
+
+### TxBuilder setValidity API
+
+Add `setValidity()` method to TxBuilder for setting transaction validity intervals:
+
+```ts
+client.newTx()
+  .setValidity({ 
+    from: Date.now(),           // Valid after this Unix time (optional)
+    to: Date.now() + 300_000    // Expires after this Unix time (optional)
+  })
+  .payToAddress({ ... })
+  .build()
+```
+
+- Times are provided as Unix milliseconds and converted to slots during transaction assembly
+- At least one of `from` or `to` must be specified
+- Validates that `from < to` when both are provided
+
+### slotConfig support for devnets
+
+Add `slotConfig` parameter to `createClient()` for custom slot configurations:
+
+```ts
+const slotConfig = Cluster.getSlotConfig(devnetCluster)
+const client = createClient({ 
+  network: 0, 
+  slotConfig,  // Custom slot config for devnet
+  provider: { ... }, 
+  wallet: { ... } 
+})
+```
+
+Priority chain for slot config resolution:
+1. `BuildOptions.slotConfig` (per-transaction override)
+2. `TxBuilderConfig.slotConfig` (client default)
+3. `SLOT_CONFIG_NETWORK[network]` (hardcoded fallback)
+
+### Cluster.getSlotConfig helper
+
+Add `getSlotConfig()` helper to derive slot configuration from devnet cluster genesis:
+
+```ts
+const slotConfig = Cluster.getSlotConfig(cluster)
+// Returns: { zeroTime, zeroSlot, slotLength }
+```

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

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

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

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

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

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

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

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

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

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

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

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

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

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

docs/content/docs/modules/sdk/PoolParams.mdx

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

docs/content/docs/modules/sdk/ProtocolParameters.mdx

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