Scheduled Transfers

The Scheduled Transfers module allows users to schedule token transfers to occur at a future time, with an optional recurring schedule. It is an executor that is installed on an account and can be triggered by an automation service at the pre-specified time(s).

You can find the source code for the module in the Core Modules repo (opens in a new tab) and the deployment address in the address book.

`ScheduledTransfer` type

The ScheduledTransfer type is an object that represents a scheduled transfer. It has the following properties:

type ScheduledTransfer = Schedule & {
  token?: ERC20Token;
  amount: number;
  recipient: Hex;
  maxGasPrice?: number;
};
 
export type Schedule = {
  startDate: number; // UNIX timestamp
  repeatEvery: number; // In seconds
  numberOfRepeats: number;
};
 
export type ERC20Token = {
  token_address: Address;
  decimals: number;
};

`getScheduledTransferData`

The getScheduledTransferData function is used to create a hex-encoded struct that represents the scheduled transfer.

import { getScheduledTransferData } from "@rhinestone/module-sdk";
 
const isNativeToken = true;
const scheduledTransfer = {
  startDate: 1710759572,
  repeatEvery: 60 * 60 * 24, // 1 day
  numberOfRepeats: 10,
  token: {
    token_address: "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", // USDC
    decimals: 6,
  },
  amount: 10,
  recipient: "0x5678...",
};
 
const scheduledTransferData = getScheduledTransferData({
  isNativeToken,
  scheduledTransafer,
});

`getScheduledTransfersExecutor`

The getScheduledTransfersExecutor function is used to create an instance of the Scheduled Transfers module. The executionInterval is a number that designates the interval at which the execution should occur in seconds. The numberOfExecutions is a number that designates how many times this transfer should be executed. The startDate is the UNIX timestamp of when the first execution should occur. The executionData object is a hex-encoded struct of type Execution that represents the transfer. If it is a native token transfer, the value should be used, otherwise the callData should be an ERC-20 transfer. This function returns a module object.

import {
  getScheduledTransfersExecutor,
  getScheduledTransferData,
} from "@rhinestone/module-sdk";
 
const executionInterval = 60 _ 60 _ 24; // 1 day
const numberOfExecutions = 10;
const startDate = 1710759572; // UNIX timestamp
const executionData = getScheduledTransferData({...});
 
const scheduledTransfersExecutor = getScheduledTransfersExecutor({
executionInterval,
numberOfExecutions,
startDate,
executionData,
});

`getCreateScheduledTransferAction`

The getCreateScheduledTransferAction function is used to create an execution that can be used to schedule a transfer. The isNativeToken argument is a boolean flag for whether a token is native or not. The scheduledTransfer is an object of type ScheduledTransfer which includes the details for the scheduled transfer. This function returns an execution object.

import { getCreateScheduledTransferAction } from "@rhinestone/module-sdk";
 
const isNativeToken = true;
const scheduledTransfer = {
  startDate: 1710759572,
  repeatEvery: 60 * 60 * 24, // 1 day
  numberOfRepeats: 10,
  token: {
    name: "USD Coin",
    symbol: "USDC",
    token_address: "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    decimals: 6,
    chainId: 1,
  },
  amount: 10,
  recipient: "0x5678...",
};
 
const scheduledTransferExecution = getCreateScheduledTransferAction({
  isNativeToken,
  scheduledTransfer,
});

`getExecuteScheduledTransferAction`

The getExecuteScheduledTransferAction function is used to create an execution for execute scheduled transfer. This function returns an execution object.

import { getExecuteScheduledTransferAction } from "@rhinestone/module-sdk";
 
const executeScheduledTranferAction = getExecuteScheduledTransferAction({
  jobId: 1,
});