feat: update docs

Author: solidsnakedev

docs/content/docs/modules/sdk/builders/SignBuilder.mdx

@@ -25,11 +25,21 @@ SignBuilder extends TransactionResultBase with signing capabilities.
 Only available when the client has a signing wallet (seed, private key, or API wallet).
 Provides access to unsigned transaction (via base interface) and signing operations.
 
+Includes `chainResult` for transaction chaining - use `chainResult.available` as
+`availableUtxos` for the next transaction in a chain.
+
 **Signature**
 
 ```ts
 export interface SignBuilder extends TransactionResultBase, EffectToPromiseAPI<SignBuilderEffect> {
   readonly Effect: SignBuilderEffect
+  /**
+   * Compute chain result for building dependent transactions.
+   * Contains consumed UTxOs, available UTxOs (remaining + created), and txHash.
+   *
+   * Result is memoized - computed once on first call, cached for subsequent calls.
+   */
+  readonly chainResult: () => ChainResult
 }
 ```
 
@@ -52,6 +62,7 @@ export interface SignBuilderEffect {
 
   // Signing methods
   readonly sign: () => Effect.Effect<SubmitBuilder, TransactionBuilderError>
+  readonly signAndSubmit: () => Effect.Effect<string, TransactionBuilderError>
   readonly signWithWitness: (
     witnessSet: TransactionWitnessSet.TransactionWitnessSet
   ) => Effect.Effect<SubmitBuilder, TransactionBuilderError>

docs/content/docs/modules/sdk/builders/SignBuilderImpl.mdx

@@ -46,6 +46,8 @@ export declare const makeSignBuilder: (params: {
   referenceUtxos: ReadonlyArray<CoreUTxO.UTxO>
   provider: Provider.Provider
   wallet: Wallet
+  outputs: ReadonlyArray<TxOut.TransactionOutput>
+  availableUtxos: ReadonlyArray<CoreUTxO.UTxO>
 }) => SignBuilder
 ```
 

docs/content/docs/modules/sdk/builders/TransactionBuilder.mdx

@@ -629,6 +629,36 @@ export interface TransactionBuilderBase {
    * @category builder-methods
    */
   readonly addSigner: (params: AddSignerParams) => this
+
+  // ============================================================================
+  // Transaction Chaining Methods
+  // ============================================================================
+
+  /**
+   * Execute transaction build and return consumed/available UTxOs for chaining.
+   *
+   * Runs the full build pipeline (coin selection, fee calculation, evaluation) and returns
+   * which UTxOs were consumed and which remain available for subsequent transactions.
+   * Use this when building multiple dependent transactions in sequence.
+   *
+   * @returns Promise<ChainResult> with consumed and available UTxOs
+   *
+   * @example
+   * ```typescript
+   * // Build first transaction, get remaining UTxOs
+   * const tx1 = await builder
+   *   .payTo({ address, value: { lovelace: 5_000_000n } })
+   *   .build({ availableUtxos: walletUtxos })
+   *
+   * // Build second transaction using remaining UTxOs from chainResult
+   * const tx2 = await builder
+   *   .payTo({ address, value: { lovelace: 3_000_000n } })
+   *   .build({ availableUtxos: tx1.chainResult().available })
+   * ```
+   *
+   * @since 2.0.0
+   * @category chaining-methods
+   */
 }
 ````
 
@@ -1021,17 +1051,22 @@ Added in v2.0.0
 
 Result type for transaction chaining operations.
 
-**NOTE: NOT YET IMPLEMENTED** - This interface is reserved for future implementation
-of multi-transaction workflows. Current chain methods return stub implementations.
+Provides consumed and available UTxOs for building chained transactions.
+The available UTxOs include both remaining unspent inputs AND newly created outputs
+with pre-computed txHash, ready to be spent in subsequent transactions.
+
+Accessed via `SignBuilder.chainResult()` after calling `build()`.
 
 **Signature**
 
 ```ts
 export interface ChainResult {
-  readonly transaction: Transaction.Transaction
-  readonly newOutputs: ReadonlyArray<CoreUTxO.UTxO> // UTxOs created by this transaction
-  readonly updatedUtxos: ReadonlyArray<CoreUTxO.UTxO> // Available UTxOs for next transaction (original - spent + new)
-  readonly spentUtxos: ReadonlyArray<CoreUTxO.UTxO> // UTxOs consumed by this transaction
+  /** UTxOs consumed from availableUtxos by coin selection */
+  readonly consumed: ReadonlyArray<CoreUTxO.UTxO>
+  /** Available UTxOs: remaining unspent + newly created (with computed txHash) */
+  readonly available: ReadonlyArray<CoreUTxO.UTxO>
+  /** Pre-computed transaction hash (blake2b-256 of transaction body) */
+  readonly txHash: string
 }
 ```
 

packages/evolution/docs/modules/sdk/builders/SignBuilder.ts.md

@@ -25,11 +25,21 @@ SignBuilder extends TransactionResultBase with signing capabilities.
 Only available when the client has a signing wallet (seed, private key, or API wallet).
 Provides access to unsigned transaction (via base interface) and signing operations.
 
+Includes `chainResult` for transaction chaining - use `chainResult.available` as
+`availableUtxos` for the next transaction in a chain.
+
 **Signature**
 
 ```ts
 export interface SignBuilder extends TransactionResultBase, EffectToPromiseAPI<SignBuilderEffect> {
   readonly Effect: SignBuilderEffect
+  /**
+   * Compute chain result for building dependent transactions.
+   * Contains consumed UTxOs, available UTxOs (remaining + created), and txHash.
+   *
+   * Result is memoized - computed once on first call, cached for subsequent calls.
+   */
+  readonly chainResult: () => ChainResult
 }
 ```
 
@@ -52,6 +62,7 @@ export interface SignBuilderEffect {
 
   // Signing methods
   readonly sign: () => Effect.Effect<SubmitBuilder, TransactionBuilderError>
+  readonly signAndSubmit: () => Effect.Effect<string, TransactionBuilderError>
   readonly signWithWitness: (
     witnessSet: TransactionWitnessSet.TransactionWitnessSet
   ) => Effect.Effect<SubmitBuilder, TransactionBuilderError>

packages/evolution/docs/modules/sdk/builders/SignBuilderImpl.ts.md

@@ -46,6 +46,8 @@ export declare const makeSignBuilder: (params: {
   referenceUtxos: ReadonlyArray<CoreUTxO.UTxO>
   provider: Provider.Provider
   wallet: Wallet
+  outputs: ReadonlyArray<TxOut.TransactionOutput>
+  availableUtxos: ReadonlyArray<CoreUTxO.UTxO>
 }) => SignBuilder
 ```
 

packages/evolution/docs/modules/sdk/builders/TransactionBuilder.ts.md

@@ -629,6 +629,36 @@ export interface TransactionBuilderBase {
    * @category builder-methods
    */
   readonly addSigner: (params: AddSignerParams) => this
+
+  // ============================================================================
+  // Transaction Chaining Methods
+  // ============================================================================
+
+  /**
+   * Execute transaction build and return consumed/available UTxOs for chaining.
+   *
+   * Runs the full build pipeline (coin selection, fee calculation, evaluation) and returns
+   * which UTxOs were consumed and which remain available for subsequent transactions.
+   * Use this when building multiple dependent transactions in sequence.
+   *
+   * @returns Promise<ChainResult> with consumed and available UTxOs
+   *
+   * @example
+   * ```typescript
+   * // Build first transaction, get remaining UTxOs
+   * const tx1 = await builder
+   *   .payTo({ address, value: { lovelace: 5_000_000n } })
+   *   .build({ availableUtxos: walletUtxos })
+   *
+   * // Build second transaction using remaining UTxOs from chainResult
+   * const tx2 = await builder
+   *   .payTo({ address, value: { lovelace: 3_000_000n } })
+   *   .build({ availableUtxos: tx1.chainResult().available })
+   * ```
+   *
+   * @since 2.0.0
+   * @category chaining-methods
+   */
 }
 ````
 
@@ -1021,17 +1051,22 @@ Added in v2.0.0
 
 Result type for transaction chaining operations.
 
-**NOTE: NOT YET IMPLEMENTED** - This interface is reserved for future implementation
-of multi-transaction workflows. Current chain methods return stub implementations.
+Provides consumed and available UTxOs for building chained transactions.
+The available UTxOs include both remaining unspent inputs AND newly created outputs
+with pre-computed txHash, ready to be spent in subsequent transactions.
+
+Accessed via `SignBuilder.chainResult()` after calling `build()`.
 
 **Signature**
 
 ```ts
 export interface ChainResult {
-  readonly transaction: Transaction.Transaction
-  readonly newOutputs: ReadonlyArray<CoreUTxO.UTxO> // UTxOs created by this transaction
-  readonly updatedUtxos: ReadonlyArray<CoreUTxO.UTxO> // Available UTxOs for next transaction (original - spent + new)
-  readonly spentUtxos: ReadonlyArray<CoreUTxO.UTxO> // UTxOs consumed by this transaction
+  /** UTxOs consumed from availableUtxos by coin selection */
+  readonly consumed: ReadonlyArray<CoreUTxO.UTxO>
+  /** Available UTxOs: remaining unspent + newly created (with computed txHash) */
+  readonly available: ReadonlyArray<CoreUTxO.UTxO>
+  /** Pre-computed transaction hash (blake2b-256 of transaction body) */
+  readonly txHash: string
 }
 ```
 

packages/evolution/src/sdk/builders/SignBuilder.ts

@@ -57,14 +57,6 @@ export interface SignBuilder extends TransactionResultBase, EffectToPromiseAPI<S
    * Contains consumed UTxOs, available UTxOs (remaining + created), and txHash.
    * 
    * Result is memoized - computed once on first call, cached for subsequent calls.
-   * 
-   * @example
-   * ```typescript
-   * const tx1 = await client.newTx().payToAddress(...).build({ availableUtxos: walletUtxos })
-   * const tx2 = await client.newTx().payToAddress(...).build({ availableUtxos: tx1.chainResult().available })
-   * await tx1.sign().submit()
-   * await tx2.sign().submit()
-   * ```
    */
   readonly chainResult: () => ChainResult
 }

packages/evolution/src/sdk/builders/TransactionBuilder.ts

@@ -519,19 +519,6 @@ const buildPartialEffectCore = (
  *
  * Accessed via `SignBuilder.chainResult()` after calling `build()`.
  *
- * @example
- * ```ts
- * const tx1 = await TxBuilder.create(sdk)
- *   .payTo({ address, value: { lovelace: 5_000_000n } })
- *   .build({ availableUtxos: walletUtxos })
- *
- * // tx1.chainResult().available contains remaining unspent + new UTxOs with computed txHash
- *
- * const tx2 = await TxBuilder.create(sdk)
- *   .payTo({ address, value: { lovelace: 3_000_000n } })
- *   .build({ availableUtxos: tx1.chainResult().available })
- * ```
- *
  * @since 2.0.0
  * @category model
  */