viem 2.43.4 → 2.44.0

package/_types/tempo/actions/reward.d.ts

@@ -162,156 +162,15 @@ export declare namespace claimSync {
     type ErrorType = claim.ErrorType;
 }
 /**
- * Gets the total reward per second rate for all active streams.
+ * Distributes rewards to opted-in token holders.
  *
- * Returns the current aggregate per-second emission rate scaled by `ACC_PRECISION` (1e18).
- * This value represents the sum of all active reward streams' emission rates.
- * The rate decreases when streams end (via `finalizeStreams`) or are canceled.
+ * This function transfers `amount` of tokens from the caller into the token contract's
+ * reward pool and immediately distributes them to current opted-in holders by increasing
+ * `globalRewardPerToken`.
  *
- * @example
- * ```ts
- * import { createClient, http } from 'viem'
- * import { tempo } from 'tempo.ts/chains'
- * import { Actions } from 'tempo.ts/viem'
- *
- * const client = createClient({
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
- *   transport: http(),
- * })
- *
- * const rate = await Actions.rewards.getTotalPerSecond(client, {
- *   token: '0x20c0000000000000000000000000000000000001',
- * })
- * ```
- *
- * @param client - Client.
- * @param parameters - Parameters.
- * @returns The total reward per second (scaled by 1e18).
- */
-export declare function getTotalPerSecond<chain extends Chain | undefined>(client: Client<Transport, chain>, parameters: getTotalPerSecond.Parameters): Promise<getTotalPerSecond.ReturnValue>;
-export declare namespace getTotalPerSecond {
-    type Parameters = ReadParameters & Args;
-    type Args = {
-        /** The TIP20 token address */
-        token: Address;
-    };
-    type ReturnValue = ReadContractReturnType<typeof Abis.tip20, 'totalRewardPerSecond', never>;
-    /**
-     * Defines a call to the `totalRewardPerSecond` function.
-     *
-     * @param args - Arguments.
-     * @returns The call.
-     */
-    function call(args: Args): {
-        abi: [{
-            readonly name: "totalRewardPerSecond";
-            readonly type: "function";
-            readonly stateMutability: "view";
-            readonly inputs: readonly [];
-            readonly outputs: readonly [{
-                readonly type: "uint256";
-            }];
-        }];
-        functionName: "totalRewardPerSecond";
-    } & {
-        args?: readonly [] | undefined;
-    } & {
-        address: Address;
-    } & {
-        data: import("../../index.js").Hex;
-        to: Address;
-    };
-}
-/**
- * Gets the reward information for a specific account.
- *
- * Returns the reward recipient address, reward per token value, and accumulated reward balance for the specified account.
- * This information includes:
- * - `rewardRecipient`: The address designated to receive rewards (zero address if opted out)
- * - `rewardPerToken`: The reward per token value for this account
- * - `rewardBalance`: The accumulated reward balance waiting to be claimed
- *
- * @example
- * ```ts
- * import { createClient, http } from 'viem'
- * import { tempo } from 'tempo.ts/chains'
- * import { Actions } from 'tempo.ts/viem'
- *
- * const client = createClient({
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
- *   transport: http(),
- * })
- *
- * const info = await Actions.reward.getUserRewardInfo(client, {
- *   token: '0x20c0000000000000000000000000000000000001',
- *   account: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
- * })
- * ```
- *
- * @param client - Client.
- * @param parameters - Parameters.
- * @returns The user's reward information (recipient, rewardPerToken, rewardBalance).
- */
-export declare function getUserRewardInfo<chain extends Chain | undefined>(client: Client<Transport, chain>, parameters: getUserRewardInfo.Parameters): Promise<getUserRewardInfo.ReturnValue>;
-export declare namespace getUserRewardInfo {
-    type Parameters = ReadParameters & Args;
-    type Args = {
-        /** The account address to query reward info for */
-        account: Address;
-        /** The TIP20 token address */
-        token: Address;
-    };
-    type ReturnValue = ReadContractReturnType<typeof Abis.tip20, 'userRewardInfo', never>;
-    /**
-     * Defines a call to the `userRewardInfo` function.
-     *
-     * @param args - Arguments.
-     * @returns The call.
-     */
-    function call(args: Args): {
-        abi: [{
-            readonly name: "userRewardInfo";
-            readonly type: "function";
-            readonly stateMutability: "view";
-            readonly inputs: readonly [{
-                readonly type: "address";
-                readonly name: "account";
-            }];
-            readonly outputs: readonly [{
-                readonly type: "tuple";
-                readonly components: readonly [{
-                    readonly type: "address";
-                    readonly name: "rewardRecipient";
-                }, {
-                    readonly type: "uint256";
-                    readonly name: "rewardPerToken";
-                }, {
-                    readonly type: "uint256";
-                    readonly name: "rewardBalance";
-                }];
-            }];
-        }];
-        functionName: "userRewardInfo";
-    } & {
-        args: readonly [account: `0x${string}`];
-    } & {
-        address: Address;
-    } & {
-        data: import("../../index.js").Hex;
-        to: Address;
-    };
-}
-/**
- * Sets or changes the reward recipient for a token holder.
- *
- * This function allows a token holder to designate who should receive their share of rewards:
- * - If `recipient` is the zero address, opts out from rewards distribution.
- * - Otherwise, opts in and sets `recipient` as the address that will receive accrued rewards.
- * - Can be called with `recipient == msg.sender` to receive rewards directly.
- * - Automatically distributes any accrued rewards to the current recipient before changing.
- *
- * TIP-403 Policy:
- * - Reverts with `PolicyForbids` if `recipient` is not the zero address and either the holder or recipient is not authorized to receive tokens under the token's transfer policy.
+ * Notes:
+ * - Reverts with `InvalidAmount` if `amount == 0`.
+ * - The transfer from caller to pool is subject to TIP-403 policy checks.
  *
  * @example
  * ```ts
@@ -326,8 +185,8 @@ export declare namespace getUserRewardInfo {
  *   transport: http(),
  * })
  *
- * const hash = await Actions.rewards.setRecipient(client, {
- *   recipient: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
+ * const hash = await Actions.reward.distribute(client, {
+ *   amount: 100000000000000000000n,
  *   token: '0x20c0000000000000000000000000000000000001',
  * })
  * ```
@@ -336,18 +195,17 @@ export declare namespace getUserRewardInfo {
  * @param parameters - Parameters.
  * @returns The transaction hash.
  */
-export declare function setRecipient<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: setRecipient.Parameters<chain, account>): Promise<setRecipient.ReturnValue>;
+export declare function distribute<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: distribute.Parameters<chain, account>): Promise<distribute.ReturnValue>;
 /**
- * Sets or changes the reward recipient for a token holder and waits for confirmation.
+ * Distributes rewards to opted-in token holders and waits for confirmation.
  *
- * This function allows a token holder to designate who should receive their share of rewards:
- * - If `recipient` is the zero address, opts out from rewards distribution.
- * - Otherwise, opts in and sets `recipient` as the address that will receive accrued rewards.
- * - Can be called with `recipient == msg.sender` to receive rewards directly.
- * - Automatically distributes any accrued rewards to the current recipient before changing.
+ * This function transfers `amount` of tokens from the caller into the token contract's
+ * reward pool and immediately distributes them to current opted-in holders by increasing
+ * `globalRewardPerToken`.
  *
- * TIP-403 Policy:
- * - Reverts with `PolicyForbids` if `recipient` is not the zero address and either the holder or recipient is not authorized to receive tokens under the token's transfer policy.
+ * Notes:
+ * - Reverts with `InvalidAmount` if `amount == 0`.
+ * - The transfer from caller to pool is subject to TIP-403 policy checks.
  *
  * @example
  * ```ts
@@ -362,21 +220,21 @@ export declare function setRecipient<chain extends Chain | undefined, account ex
  *   transport: http(),
  * })
  *
- * const { holder, recipient, receipt } = await Actions.rewards.setRecipientSync(client, {
- *   recipient: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
+ * const { amount, funder, receipt } = await Actions.reward.distributeSync(client, {
+ *   amount: 100000000000000000000n,
  *   token: '0x20c0000000000000000000000000000000000001',
  * })
  * ```
  *
  * @param client - Client.
  * @param parameters - Parameters.
- * @returns The holder, recipient, and transaction receipt.
+ * @returns The funder, amount, and transaction receipt.
  */
-export declare function setRecipientSync<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: setRecipientSync.Parameters<chain, account>): Promise<setRecipientSync.ReturnValue>;
-export declare namespace setRecipient {
+export declare function distributeSync<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: distributeSync.Parameters<chain, account>): Promise<distributeSync.ReturnValue>;
+export declare namespace distribute {
     type Args = {
-        /** The reward recipient address (use zero address to opt out of rewards) */
-        recipient: Address;
+        /** The amount of tokens to distribute (must be > 0) */
+        amount: bigint;
         /** The TIP20 token address */
         token: Address;
     };
@@ -386,7 +244,7 @@ export declare namespace setRecipient {
     /** @internal */
     function inner<action extends typeof writeContract | typeof writeContractSync, chain extends Chain | undefined, account extends Account | undefined>(action: action, client: Client<Transport, chain, account>, parameters: Parameters<chain, account>): Promise<ReturnType<action>>;
     /**
-     * Defines a call to the `setRecipient` function.
+     * Defines a call to the `distributeReward` function.
      *
      * Can be passed as a parameter to:
      * - [`estimateContractGas`](https://viem.sh/docs/contract/estimateContractGas): estimate the gas cost of the call
@@ -405,8 +263,8 @@ export declare namespace setRecipient {
      * }).extend(walletActions)
      *
      * const hash = await client.sendTransaction({
-     *   calls: [actions.rewards.setRecipient.call({
-     *     recipient: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
+     *   calls: [actions.reward.distribute.call({
+     *     amount: 100000000000000000000n,
      *     token: '0x20c0000000000000000000000000000000000001',
      *   })],
      * })
@@ -417,18 +275,18 @@ export declare namespace setRecipient {
      */
     function call(args: Args): {
         abi: [{
-            readonly name: "setRewardRecipient";
+            readonly name: "distributeReward";
             readonly type: "function";
             readonly stateMutability: "nonpayable";
             readonly inputs: readonly [{
-                readonly type: "address";
-                readonly name: "recipient";
+                readonly type: "uint256";
+                readonly name: "amount";
             }];
             readonly outputs: readonly [];
         }];
-        functionName: "setRewardRecipient";
+        functionName: "distributeReward";
     } & {
-        args: readonly [recipient: `0x${string}`];
+        args: readonly [amount: bigint];
     } & {
         address: Address;
     } & {
@@ -436,10 +294,10 @@ export declare namespace setRecipient {
         to: Address;
     };
     /**
-     * Extracts the `RewardRecipientSet` event from logs.
+     * Extracts the `RewardDistributed` event from logs.
      *
      * @param logs - The logs.
-     * @returns The `RewardRecipientSet` event.
+     * @returns The `RewardDistributed` event.
      */
     function extractEvent(logs: Log[]): Log<bigint, number, false, undefined, true, readonly [{
         readonly name: "name";
@@ -686,25 +544,6 @@ export declare namespace setRecipient {
         readonly outputs: readonly [{
             readonly type: "bool";
         }];
-    }, {
-        readonly name: "feeRecipient";
-        readonly type: "function";
-        readonly stateMutability: "view";
-        readonly inputs: readonly [];
-        readonly outputs: readonly [{
-            readonly type: "address";
-        }];
-    }, {
-        readonly name: "setFeeRecipient";
-        readonly type: "function";
-        readonly stateMutability: "view";
-        readonly inputs: readonly [{
-            readonly type: "address";
-            readonly name: "newRecipient";
-        }];
-        readonly outputs: readonly [{
-            readonly type: "address";
-        }];
     }, {
         readonly name: "changeTransferPolicyId";
         readonly type: "function";
@@ -783,19 +622,14 @@ export declare namespace setRecipient {
             readonly type: "bytes32";
         }];
     }, {
-        readonly name: "startReward";
+        readonly name: "distributeReward";
         readonly type: "function";
         readonly stateMutability: "nonpayable";
         readonly inputs: readonly [{
             readonly type: "uint256";
             readonly name: "amount";
-        }, {
-            readonly type: "uint32";
-            readonly name: "secs";
-        }];
-        readonly outputs: readonly [{
-            readonly type: "uint64";
         }];
+        readonly outputs: readonly [];
     }, {
         readonly name: "setRewardRecipient";
         readonly type: "function";
@@ -805,17 +639,6 @@ export declare namespace setRecipient {
             readonly name: "recipient";
         }];
         readonly outputs: readonly [];
-    }, {
-        readonly name: "cancelReward";
-        readonly type: "function";
-        readonly stateMutability: "nonpayable";
-        readonly inputs: readonly [{
-            readonly type: "uint64";
-            readonly name: "id";
-        }];
-        readonly outputs: readonly [{
-            readonly type: "uint256";
-        }];
     }, {
         readonly name: "claimRewards";
         readonly type: "function";
@@ -824,50 +647,6 @@ export declare namespace setRecipient {
         readonly outputs: readonly [{
             readonly type: "uint256";
         }];
-    }, {
-        readonly name: "finalizeStreams";
-        readonly type: "function";
-        readonly stateMutability: "nonpayable";
-        readonly inputs: readonly [{
-            readonly type: "uint64";
-            readonly name: "timestamp";
-        }];
-        readonly outputs: readonly [];
-    }, {
-        readonly name: "getStream";
-        readonly type: "function";
-        readonly stateMutability: "view";
-        readonly inputs: readonly [{
-            readonly type: "uint64";
-            readonly name: "id";
-        }];
-        readonly outputs: readonly [{
-            readonly type: "tuple";
-            readonly components: readonly [{
-                readonly type: "address";
-                readonly name: "funder";
-            }, {
-                readonly type: "uint64";
-                readonly name: "startTime";
-            }, {
-                readonly type: "uint64";
-                readonly name: "endTime";
-            }, {
-                readonly type: "uint256";
-                readonly name: "ratePerSecondScaled";
-            }, {
-                readonly type: "uint256";
-                readonly name: "amountTotal";
-            }];
-        }];
-    }, {
-        readonly name: "totalRewardPerSecond";
-        readonly type: "function";
-        readonly stateMutability: "view";
-        readonly inputs: readonly [];
-        readonly outputs: readonly [{
-            readonly type: "uint256";
-        }];
     }, {
         readonly name: "optedInSupply";
         readonly type: "function";
@@ -877,12 +656,12 @@ export declare namespace setRecipient {
             readonly type: "uint128";
         }];
     }, {
-        readonly name: "nextStreamId";
+        readonly name: "globalRewardPerToken";
         readonly type: "function";
         readonly stateMutability: "view";
         readonly inputs: readonly [];
         readonly outputs: readonly [{
-            readonly type: "uint64";
+            readonly type: "uint256";
         }];
     }, {
         readonly name: "userRewardInfo";
@@ -905,6 +684,17 @@ export declare namespace setRecipient {
                 readonly name: "rewardBalance";
             }];
         }];
+    }, {
+        readonly name: "getPendingRewards";
+        readonly type: "function";
+        readonly stateMutability: "view";
+        readonly inputs: readonly [{
+            readonly type: "address";
+            readonly name: "account";
+        }];
+        readonly outputs: readonly [{
+            readonly type: "uint128";
+        }];
     }, {
         readonly name: "Transfer";
         readonly type: "event";
@@ -1047,37 +837,15 @@ export declare namespace setRecipient {
             readonly indexed: true;
         }];
     }, {
-        readonly name: "RewardScheduled";
+        readonly name: "RewardDistributed";
         readonly type: "event";
         readonly inputs: readonly [{
             readonly type: "address";
             readonly name: "funder";
             readonly indexed: true;
-        }, {
-            readonly type: "uint64";
-            readonly name: "id";
-            readonly indexed: true;
         }, {
             readonly type: "uint256";
             readonly name: "amount";
-        }, {
-            readonly type: "uint32";
-            readonly name: "durationSeconds";
-        }];
-    }, {
-        readonly name: "RewardCanceled";
-        readonly type: "event";
-        readonly inputs: readonly [{
-            readonly type: "address";
-            readonly name: "funder";
-            readonly indexed: true;
-        }, {
-            readonly type: "uint64";
-            readonly name: "id";
-            readonly indexed: true;
-        }, {
-            readonly type: "uint256";
-            readonly name: "refund";
         }];
     }, {
         readonly name: "RewardRecipientSet";
@@ -1091,18 +859,6 @@ export declare namespace setRecipient {
             readonly name: "recipient";
             readonly indexed: true;
         }];
-    }, {
-        readonly name: "FeeRecipientUpdated";
-        readonly type: "event";
-        readonly inputs: readonly [{
-            readonly type: "address";
-            readonly name: "updater";
-            readonly indexed: true;
-        }, {
-            readonly type: "address";
-            readonly name: "newRecipient";
-            readonly indexed: true;
-        }];
     }, {
         readonly name: "InsufficientBalance";
         readonly type: "error";
@@ -1164,14 +920,6 @@ export declare namespace setRecipient {
         readonly name: "InvalidAmount";
         readonly type: "error";
         readonly inputs: readonly [];
-    }, {
-        readonly name: "NotStreamFunder";
-        readonly type: "error";
-        readonly inputs: readonly [];
-    }, {
-        readonly name: "StreamInactive";
-        readonly type: "error";
-        readonly inputs: readonly [];
     }, {
         readonly name: "NoOptedInSupply";
         readonly type: "error";
@@ -1181,19 +929,19 @@ export declare namespace setRecipient {
         readonly type: "error";
         readonly inputs: readonly [];
     }, {
-        readonly name: "RewardsDisabled";
+        readonly name: "ProtectedAddress";
         readonly type: "error";
         readonly inputs: readonly [];
     }, {
-        readonly name: "ScheduledRewardsDisabled";
+        readonly name: "InvalidToken";
         readonly type: "error";
         readonly inputs: readonly [];
     }, {
-        readonly name: "ProtectedAddress";
+        readonly name: "Uninitialized";
         readonly type: "error";
         readonly inputs: readonly [];
     }, {
-        readonly name: "InvalidToken";
+        readonly name: "InvalidTransferPolicyId";
         readonly type: "error";
         readonly inputs: readonly [];
     }, {
@@ -1301,38 +1049,239 @@ export declare namespace setRecipient {
             readonly name: "sender";
             readonly indexed: true;
         }];
-    }, {
-        readonly name: "Unauthorized";
-        readonly type: "error";
-        readonly inputs: readonly [];
-    }], "RewardRecipientSet">;
-}
-export declare namespace setRecipientSync {
-    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = WriteParameters<chain, account> & setRecipient.Args;
-    type ReturnValue = {
-        /** The token holder address who set their reward recipient */
-        holder: Address;
-        /** The transaction receipt */
-        receipt: Awaited<ReturnType<typeof writeContractSync>>;
-        /** The reward recipient address (zero address indicates opt-out) */
-        recipient: Address;
+    }, {
+        readonly name: "Unauthorized";
+        readonly type: "error";
+        readonly inputs: readonly [];
+    }], "RewardDistributed">;
+}
+export declare namespace distributeSync {
+    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = WriteParameters<chain, account> & distribute.Args;
+    type ReturnValue = {
+        /** The amount distributed */
+        amount: bigint;
+        /** The address that funded the distribution */
+        funder: Address;
+        /** The transaction receipt */
+        receipt: Awaited<ReturnType<typeof writeContractSync>>;
+    };
+    type ErrorType = distribute.ErrorType;
+}
+/**
+ * Gets the global reward per token value.
+ *
+ * Returns the current global reward per token value scaled by `ACC_PRECISION` (1e18).
+ * This value increases each time rewards are distributed.
+ *
+ * @example
+ * ```ts
+ * import { createClient, http } from 'viem'
+ * import { tempo } from 'tempo.ts/chains'
+ * import { Actions } from 'tempo.ts/viem'
+ *
+ * const client = createClient({
+ *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+ *   transport: http(),
+ * })
+ *
+ * const rewardPerToken = await Actions.reward.getGlobalRewardPerToken(client, {
+ *   token: '0x20c0000000000000000000000000000000000001',
+ * })
+ * ```
+ *
+ * @param client - Client.
+ * @param parameters - Parameters.
+ * @returns The global reward per token (scaled by 1e18).
+ */
+export declare function getGlobalRewardPerToken<chain extends Chain | undefined>(client: Client<Transport, chain>, parameters: getGlobalRewardPerToken.Parameters): Promise<getGlobalRewardPerToken.ReturnValue>;
+export declare namespace getGlobalRewardPerToken {
+    type Parameters = ReadParameters & Args;
+    type Args = {
+        /** The TIP20 token address */
+        token: Address;
+    };
+    type ReturnValue = ReadContractReturnType<typeof Abis.tip20, 'globalRewardPerToken', never>;
+    /**
+     * Defines a call to the `globalRewardPerToken` function.
+     *
+     * @param args - Arguments.
+     * @returns The call.
+     */
+    function call(args: Args): {
+        abi: [{
+            readonly name: "globalRewardPerToken";
+            readonly type: "function";
+            readonly stateMutability: "view";
+            readonly inputs: readonly [];
+            readonly outputs: readonly [{
+                readonly type: "uint256";
+            }];
+        }];
+        functionName: "globalRewardPerToken";
+    } & {
+        args?: readonly [] | undefined;
+    } & {
+        address: Address;
+    } & {
+        data: import("../../index.js").Hex;
+        to: Address;
+    };
+}
+/**
+ * Calculates the pending claimable rewards for an account without modifying state.
+ *
+ * Returns the total pending claimable reward amount, including stored balance and newly accrued rewards.
+ *
+ * @example
+ * ```ts
+ * import { createClient, http } from 'viem'
+ * import { tempo } from 'tempo.ts/chains'
+ * import { Actions } from 'tempo.ts/viem'
+ *
+ * const client = createClient({
+ *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+ *   transport: http(),
+ * })
+ *
+ * const pending = await Actions.reward.getPendingRewards(client, {
+ *   token: '0x20c0000000000000000000000000000000000001',
+ *   account: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
+ * })
+ * ```
+ *
+ * @param client - Client.
+ * @param parameters - Parameters.
+ * @returns The total pending claimable reward amount.
+ */
+export declare function getPendingRewards<chain extends Chain | undefined>(client: Client<Transport, chain>, parameters: getPendingRewards.Parameters): Promise<getPendingRewards.ReturnValue>;
+export declare namespace getPendingRewards {
+    type Parameters = ReadParameters & Args;
+    type Args = {
+        /** The account address to query pending rewards for */
+        account: Address;
+        /** The TIP20 token address */
+        token: Address;
+    };
+    type ReturnValue = ReadContractReturnType<typeof Abis.tip20, 'getPendingRewards', never>;
+    /**
+     * Defines a call to the `getPendingRewards` function.
+     *
+     * @param args - Arguments.
+     * @returns The call.
+     */
+    function call(args: Args): {
+        abi: [{
+            readonly name: "getPendingRewards";
+            readonly type: "function";
+            readonly stateMutability: "view";
+            readonly inputs: readonly [{
+                readonly type: "address";
+                readonly name: "account";
+            }];
+            readonly outputs: readonly [{
+                readonly type: "uint128";
+            }];
+        }];
+        functionName: "getPendingRewards";
+    } & {
+        args: readonly [account: `0x${string}`];
+    } & {
+        address: Address;
+    } & {
+        data: import("../../index.js").Hex;
+        to: Address;
+    };
+}
+/**
+ * Gets the reward information for a specific account.
+ *
+ * Returns the reward recipient address, reward per token value, and accumulated reward balance for the specified account.
+ * This information includes:
+ * - `rewardRecipient`: The address designated to receive rewards (zero address if opted out)
+ * - `rewardPerToken`: The reward per token value for this account
+ * - `rewardBalance`: The accumulated reward balance waiting to be claimed
+ *
+ * @example
+ * ```ts
+ * import { createClient, http } from 'viem'
+ * import { tempo } from 'tempo.ts/chains'
+ * import { Actions } from 'tempo.ts/viem'
+ *
+ * const client = createClient({
+ *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+ *   transport: http(),
+ * })
+ *
+ * const info = await Actions.reward.getUserRewardInfo(client, {
+ *   token: '0x20c0000000000000000000000000000000000001',
+ *   account: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
+ * })
+ * ```
+ *
+ * @param client - Client.
+ * @param parameters - Parameters.
+ * @returns The user's reward information (recipient, rewardPerToken, rewardBalance).
+ */
+export declare function getUserRewardInfo<chain extends Chain | undefined>(client: Client<Transport, chain>, parameters: getUserRewardInfo.Parameters): Promise<getUserRewardInfo.ReturnValue>;
+export declare namespace getUserRewardInfo {
+    type Parameters = ReadParameters & Args;
+    type Args = {
+        /** The account address to query reward info for */
+        account: Address;
+        /** The TIP20 token address */
+        token: Address;
+    };
+    type ReturnValue = ReadContractReturnType<typeof Abis.tip20, 'userRewardInfo', never>;
+    /**
+     * Defines a call to the `userRewardInfo` function.
+     *
+     * @param args - Arguments.
+     * @returns The call.
+     */
+    function call(args: Args): {
+        abi: [{
+            readonly name: "userRewardInfo";
+            readonly type: "function";
+            readonly stateMutability: "view";
+            readonly inputs: readonly [{
+                readonly type: "address";
+                readonly name: "account";
+            }];
+            readonly outputs: readonly [{
+                readonly type: "tuple";
+                readonly components: readonly [{
+                    readonly type: "address";
+                    readonly name: "rewardRecipient";
+                }, {
+                    readonly type: "uint256";
+                    readonly name: "rewardPerToken";
+                }, {
+                    readonly type: "uint256";
+                    readonly name: "rewardBalance";
+                }];
+            }];
+        }];
+        functionName: "userRewardInfo";
+    } & {
+        args: readonly [account: `0x${string}`];
+    } & {
+        address: Address;
+    } & {
+        data: import("../../index.js").Hex;
+        to: Address;
     };
-    type ErrorType = setRecipient.ErrorType;
 }
 /**
- * Starts a new reward stream that distributes tokens to opted-in holders.
+ * Sets or changes the reward recipient for a token holder.
  *
- * Behavior:
- * - Transfers `amount` of tokens from the caller into the token contract's reward pool.
- * - If `seconds == 0`: Immediately distributes `amount` to current opted-in holders by increasing `rewardPerTokenStored`.
- *   Returns stream ID `0`. Distribution occurs when holders interact with the token (transfers, etc.).
- * - If `seconds > 0`: Starts a linear stream that emits evenly from `block.timestamp` to `block.timestamp + seconds`.
- *   Returns a unique stream ID for later cancellation.
+ * This function allows a token holder to designate who should receive their share of rewards:
+ * - If `recipient` is the zero address, opts out from rewards distribution.
+ * - Otherwise, opts in and sets `recipient` as the address that will receive accrued rewards.
+ * - Can be called with `recipient == msg.sender` to receive rewards directly.
+ * - Automatically distributes any accrued rewards to the current recipient before changing.
  *
- * Notes:
- * - Reverts with `InvalidAmount` if `amount == 0`.
- * - Allowed even when `optedInSupply == 0` (tokens distributed while no one is opted in are locked permanently).
- * - The transfer from caller to pool is subject to TIP-403 policy checks.
+ * TIP-403 Policy:
+ * - Reverts with `PolicyForbids` if `recipient` is not the zero address and either the holder or recipient is not authorized to receive tokens under the token's transfer policy.
  *
  * @example
  * ```ts
@@ -1347,9 +1296,8 @@ export declare namespace setRecipientSync {
  *   transport: http(),
  * })
  *
- * const hash = await Actions.rewards.start(client, {
- *   amount: 100000000000000000000n,
- *   seconds: 86400,
+ * const hash = await Actions.reward.setRecipient(client, {
+ *   recipient: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
  *   token: '0x20c0000000000000000000000000000000000001',
  * })
  * ```
@@ -1358,21 +1306,18 @@ export declare namespace setRecipientSync {
  * @param parameters - Parameters.
  * @returns The transaction hash.
  */
-export declare function start<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: start.Parameters<chain, account>): Promise<start.ReturnValue>;
+export declare function setRecipient<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: setRecipient.Parameters<chain, account>): Promise<setRecipient.ReturnValue>;
 /**
- * Starts a new reward stream that distributes tokens to opted-in holders and waits for confirmation.
+ * Sets or changes the reward recipient for a token holder and waits for confirmation.
  *
- * Behavior:
- * - Transfers `amount` of tokens from the caller into the token contract's reward pool.
- * - If `seconds == 0`: Immediately distributes `amount` to current opted-in holders by increasing `rewardPerTokenStored`.
- *   Returns stream ID `0`. Distribution occurs when holders interact with the token (transfers, etc.).
- * - If `seconds > 0`: Starts a linear stream that emits evenly from `block.timestamp` to `block.timestamp + seconds`.
- *   Returns a unique stream ID for later cancellation.
+ * This function allows a token holder to designate who should receive their share of rewards:
+ * - If `recipient` is the zero address, opts out from rewards distribution.
+ * - Otherwise, opts in and sets `recipient` as the address that will receive accrued rewards.
+ * - Can be called with `recipient == msg.sender` to receive rewards directly.
+ * - Automatically distributes any accrued rewards to the current recipient before changing.
  *
- * Notes:
- * - Reverts with `InvalidAmount` if `amount == 0`.
- * - Allowed even when `optedInSupply == 0` (tokens distributed while no one is opted in are locked permanently).
- * - The transfer from caller to pool is subject to TIP-403 policy checks.
+ * TIP-403 Policy:
+ * - Reverts with `PolicyForbids` if `recipient` is not the zero address and either the holder or recipient is not authorized to receive tokens under the token's transfer policy.
  *
  * @example
  * ```ts
@@ -1387,22 +1332,21 @@ export declare function start<chain extends Chain | undefined, account extends A
  *   transport: http(),
  * })
  *
- * const { id, receipt } = await Actions.rewards.startSync(client, {
- *   amount: 100000000000000000000n,
- *   seconds: 86400,
+ * const { holder, recipient, receipt } = await Actions.reward.setRecipientSync(client, {
+ *   recipient: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
  *   token: '0x20c0000000000000000000000000000000000001',
  * })
  * ```
  *
  * @param client - Client.
  * @param parameters - Parameters.
- * @returns The stream ID, funder, amount, duration, and transaction receipt.
+ * @returns The holder, recipient, and transaction receipt.
  */
-export declare function startSync<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: startSync.Parameters<chain, account>): Promise<startSync.ReturnValue>;
-export declare namespace start {
+export declare function setRecipientSync<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: setRecipientSync.Parameters<chain, account>): Promise<setRecipientSync.ReturnValue>;
+export declare namespace setRecipient {
     type Args = {
-        /** The amount of tokens to distribute (must be > 0) */
-        amount: bigint;
+        /** The reward recipient address (use zero address to opt out of rewards) */
+        recipient: Address;
         /** The TIP20 token address */
         token: Address;
     };
@@ -1412,7 +1356,7 @@ export declare namespace start {
     /** @internal */
     function inner<action extends typeof writeContract | typeof writeContractSync, chain extends Chain | undefined, account extends Account | undefined>(action: action, client: Client<Transport, chain, account>, parameters: Parameters<chain, account>): Promise<ReturnType<action>>;
     /**
-     * Defines a call to the `start` function.
+     * Defines a call to the `setRewardRecipient` function.
      *
      * Can be passed as a parameter to:
      * - [`estimateContractGas`](https://viem.sh/docs/contract/estimateContractGas): estimate the gas cost of the call
@@ -1431,9 +1375,8 @@ export declare namespace start {
      * }).extend(walletActions)
      *
      * const hash = await client.sendTransaction({
-     *   calls: [actions.rewards.start.call({
-     *     amount: 100000000000000000000n,
-     *     seconds: 86400,
+     *   calls: [actions.reward.setRecipient.call({
+     *     recipient: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
      *     token: '0x20c0000000000000000000000000000000000001',
      *   })],
      * })
@@ -1444,23 +1387,18 @@ export declare namespace start {
      */
     function call(args: Args): {
         abi: [{
-            readonly name: "startReward";
+            readonly name: "setRewardRecipient";
             readonly type: "function";
             readonly stateMutability: "nonpayable";
             readonly inputs: readonly [{
-                readonly type: "uint256";
-                readonly name: "amount";
-            }, {
-                readonly type: "uint32";
-                readonly name: "secs";
-            }];
-            readonly outputs: readonly [{
-                readonly type: "uint64";
+                readonly type: "address";
+                readonly name: "recipient";
             }];
+            readonly outputs: readonly [];
         }];
-        functionName: "startReward";
+        functionName: "setRewardRecipient";
     } & {
-        args: readonly [amount: bigint, secs: number];
+        args: readonly [recipient: `0x${string}`];
     } & {
         address: Address;
     } & {
@@ -1468,10 +1406,10 @@ export declare namespace start {
         to: Address;
     };
     /**
-     * Extracts the `RewardScheduled` event from logs.
+     * Extracts the `RewardRecipientSet` event from logs.
      *
      * @param logs - The logs.
-     * @returns The `RewardScheduled` event.
+     * @returns The `RewardRecipientSet` event.
      */
     function extractEvent(logs: Log[]): Log<bigint, number, false, undefined, true, readonly [{
         readonly name: "name";
@@ -1718,25 +1656,6 @@ export declare namespace start {
         readonly outputs: readonly [{
             readonly type: "bool";
         }];
-    }, {
-        readonly name: "feeRecipient";
-        readonly type: "function";
-        readonly stateMutability: "view";
-        readonly inputs: readonly [];
-        readonly outputs: readonly [{
-            readonly type: "address";
-        }];
-    }, {
-        readonly name: "setFeeRecipient";
-        readonly type: "function";
-        readonly stateMutability: "view";
-        readonly inputs: readonly [{
-            readonly type: "address";
-            readonly name: "newRecipient";
-        }];
-        readonly outputs: readonly [{
-            readonly type: "address";
-        }];
     }, {
         readonly name: "changeTransferPolicyId";
         readonly type: "function";
@@ -1815,19 +1734,14 @@ export declare namespace start {
             readonly type: "bytes32";
         }];
     }, {
-        readonly name: "startReward";
+        readonly name: "distributeReward";
         readonly type: "function";
         readonly stateMutability: "nonpayable";
         readonly inputs: readonly [{
             readonly type: "uint256";
             readonly name: "amount";
-        }, {
-            readonly type: "uint32";
-            readonly name: "secs";
-        }];
-        readonly outputs: readonly [{
-            readonly type: "uint64";
         }];
+        readonly outputs: readonly [];
     }, {
         readonly name: "setRewardRecipient";
         readonly type: "function";
@@ -1837,17 +1751,6 @@ export declare namespace start {
             readonly name: "recipient";
         }];
         readonly outputs: readonly [];
-    }, {
-        readonly name: "cancelReward";
-        readonly type: "function";
-        readonly stateMutability: "nonpayable";
-        readonly inputs: readonly [{
-            readonly type: "uint64";
-            readonly name: "id";
-        }];
-        readonly outputs: readonly [{
-            readonly type: "uint256";
-        }];
     }, {
         readonly name: "claimRewards";
         readonly type: "function";
@@ -1856,50 +1759,6 @@ export declare namespace start {
         readonly outputs: readonly [{
             readonly type: "uint256";
         }];
-    }, {
-        readonly name: "finalizeStreams";
-        readonly type: "function";
-        readonly stateMutability: "nonpayable";
-        readonly inputs: readonly [{
-            readonly type: "uint64";
-            readonly name: "timestamp";
-        }];
-        readonly outputs: readonly [];
-    }, {
-        readonly name: "getStream";
-        readonly type: "function";
-        readonly stateMutability: "view";
-        readonly inputs: readonly [{
-            readonly type: "uint64";
-            readonly name: "id";
-        }];
-        readonly outputs: readonly [{
-            readonly type: "tuple";
-            readonly components: readonly [{
-                readonly type: "address";
-                readonly name: "funder";
-            }, {
-                readonly type: "uint64";
-                readonly name: "startTime";
-            }, {
-                readonly type: "uint64";
-                readonly name: "endTime";
-            }, {
-                readonly type: "uint256";
-                readonly name: "ratePerSecondScaled";
-            }, {
-                readonly type: "uint256";
-                readonly name: "amountTotal";
-            }];
-        }];
-    }, {
-        readonly name: "totalRewardPerSecond";
-        readonly type: "function";
-        readonly stateMutability: "view";
-        readonly inputs: readonly [];
-        readonly outputs: readonly [{
-            readonly type: "uint256";
-        }];
     }, {
         readonly name: "optedInSupply";
         readonly type: "function";
@@ -1909,12 +1768,12 @@ export declare namespace start {
             readonly type: "uint128";
         }];
     }, {
-        readonly name: "nextStreamId";
+        readonly name: "globalRewardPerToken";
         readonly type: "function";
         readonly stateMutability: "view";
         readonly inputs: readonly [];
         readonly outputs: readonly [{
-            readonly type: "uint64";
+            readonly type: "uint256";
         }];
     }, {
         readonly name: "userRewardInfo";
@@ -1937,6 +1796,17 @@ export declare namespace start {
                 readonly name: "rewardBalance";
             }];
         }];
+    }, {
+        readonly name: "getPendingRewards";
+        readonly type: "function";
+        readonly stateMutability: "view";
+        readonly inputs: readonly [{
+            readonly type: "address";
+            readonly name: "account";
+        }];
+        readonly outputs: readonly [{
+            readonly type: "uint128";
+        }];
     }, {
         readonly name: "Transfer";
         readonly type: "event";
@@ -2079,37 +1949,15 @@ export declare namespace start {
             readonly indexed: true;
         }];
     }, {
-        readonly name: "RewardScheduled";
+        readonly name: "RewardDistributed";
         readonly type: "event";
         readonly inputs: readonly [{
             readonly type: "address";
             readonly name: "funder";
             readonly indexed: true;
-        }, {
-            readonly type: "uint64";
-            readonly name: "id";
-            readonly indexed: true;
         }, {
             readonly type: "uint256";
             readonly name: "amount";
-        }, {
-            readonly type: "uint32";
-            readonly name: "durationSeconds";
-        }];
-    }, {
-        readonly name: "RewardCanceled";
-        readonly type: "event";
-        readonly inputs: readonly [{
-            readonly type: "address";
-            readonly name: "funder";
-            readonly indexed: true;
-        }, {
-            readonly type: "uint64";
-            readonly name: "id";
-            readonly indexed: true;
-        }, {
-            readonly type: "uint256";
-            readonly name: "refund";
         }];
     }, {
         readonly name: "RewardRecipientSet";
@@ -2123,18 +1971,6 @@ export declare namespace start {
             readonly name: "recipient";
             readonly indexed: true;
         }];
-    }, {
-        readonly name: "FeeRecipientUpdated";
-        readonly type: "event";
-        readonly inputs: readonly [{
-            readonly type: "address";
-            readonly name: "updater";
-            readonly indexed: true;
-        }, {
-            readonly type: "address";
-            readonly name: "newRecipient";
-            readonly indexed: true;
-        }];
     }, {
         readonly name: "InsufficientBalance";
         readonly type: "error";
@@ -2196,14 +2032,6 @@ export declare namespace start {
         readonly name: "InvalidAmount";
         readonly type: "error";
         readonly inputs: readonly [];
-    }, {
-        readonly name: "NotStreamFunder";
-        readonly type: "error";
-        readonly inputs: readonly [];
-    }, {
-        readonly name: "StreamInactive";
-        readonly type: "error";
-        readonly inputs: readonly [];
     }, {
         readonly name: "NoOptedInSupply";
         readonly type: "error";
@@ -2213,19 +2041,19 @@ export declare namespace start {
         readonly type: "error";
         readonly inputs: readonly [];
     }, {
-        readonly name: "RewardsDisabled";
+        readonly name: "ProtectedAddress";
         readonly type: "error";
         readonly inputs: readonly [];
     }, {
-        readonly name: "ScheduledRewardsDisabled";
+        readonly name: "InvalidToken";
         readonly type: "error";
         readonly inputs: readonly [];
     }, {
-        readonly name: "ProtectedAddress";
+        readonly name: "Uninitialized";
         readonly type: "error";
         readonly inputs: readonly [];
     }, {
-        readonly name: "InvalidToken";
+        readonly name: "InvalidTransferPolicyId";
         readonly type: "error";
         readonly inputs: readonly [];
     }, {
@@ -2337,26 +2165,22 @@ export declare namespace start {
         readonly name: "Unauthorized";
         readonly type: "error";
         readonly inputs: readonly [];
-    }], "RewardScheduled">;
+    }], "RewardRecipientSet">;
 }
-export declare namespace startSync {
-    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = WriteParameters<chain, account> & start.Args;
+export declare namespace setRecipientSync {
+    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = WriteParameters<chain, account> & setRecipient.Args;
     type ReturnValue = {
-        /** The total amount allocated to the stream */
-        amount: bigint;
-        /** The duration of the stream in seconds (0 for immediate distributions) */
-        durationSeconds: number;
-        /** The address that funded the stream */
-        funder: Address;
-        /** The unique stream ID (0 for immediate distributions, >0 for streaming distributions) */
-        id: bigint;
+        /** The token holder address who set their reward recipient */
+        holder: Address;
         /** The transaction receipt */
         receipt: Awaited<ReturnType<typeof writeContractSync>>;
+        /** The reward recipient address (zero address indicates opt-out) */
+        recipient: Address;
     };
-    type ErrorType = start.ErrorType;
+    type ErrorType = setRecipient.ErrorType;
 }
 /**
- * Watches for reward scheduled events.
+ * Watches for reward distributed events.
  *
  * @example
  * ```ts
@@ -2369,10 +2193,10 @@ export declare namespace startSync {
  *   transport: http(),
  * })
  *
- * const unwatch = Actions.reward.watchRewardScheduled(client, {
+ * const unwatch = Actions.reward.watchRewardDistributed(client, {
  *   token: '0x20c0000000000000000000000000000000000001',
- *   onRewardScheduled: (args, log) => {
- *     console.log('Reward scheduled:', args)
+ *   onRewardDistributed: (args, log) => {
+ *     console.log('Reward distributed:', args)
  *   },
  * })
  * ```
@@ -2381,16 +2205,16 @@ export declare namespace startSync {
  * @param parameters - Parameters.
  * @returns A function to unsubscribe from the event.
  */
-export declare function watchRewardScheduled<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: watchRewardScheduled.Parameters): WatchContractEventReturnType;
-export declare namespace watchRewardScheduled {
-    type Args = GetEventArgs<typeof Abis.tip20, 'RewardScheduled', {
+export declare function watchRewardDistributed<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: watchRewardDistributed.Parameters): WatchContractEventReturnType;
+export declare namespace watchRewardDistributed {
+    type Args = GetEventArgs<typeof Abis.tip20, 'RewardDistributed', {
         IndexedOnly: false;
         Required: true;
     }>;
-    type Log = viem_Log<bigint, number, false, ExtractAbiItem<typeof Abis.tip20, 'RewardScheduled'>, true>;
-    type Parameters = UnionOmit<WatchContractEventParameters<typeof Abis.tip20, 'RewardScheduled', true>, 'abi' | 'address' | 'batch' | 'eventName' | 'onLogs' | 'strict'> & {
-        /** Callback to invoke when rewards are scheduled. */
-        onRewardScheduled: (args: Args, log: Log) => void;
+    type Log = viem_Log<bigint, number, false, ExtractAbiItem<typeof Abis.tip20, 'RewardDistributed'>, true>;
+    type Parameters = UnionOmit<WatchContractEventParameters<typeof Abis.tip20, 'RewardDistributed', true>, 'abi' | 'address' | 'batch' | 'eventName' | 'onLogs' | 'strict'> & {
+        /** Callback to invoke when rewards are distributed. */
+        onRewardDistributed: (args: Args, log: Log) => void;
         /** The TIP20 token address */
         token: Address;
     };