Overview The Agent class provides paginated methods for querying transaction history, execution records, and logs. Each method returns a Paginator
transactions() Returns a paginator over the agent’s on-chain transactions, sorted by date.
Signature transactions ( options ?: PaginationOptions ): Paginator < Transaction >
Parameters Optional pagination and sorting configuration. Items per page. Defaults to 20.
Sort order. Use SortOrder.DATE_ASC or SortOrder.DATE_DESC.
Returns Paginator<Transaction> — an async-iterable paginator yielding Transaction objects.Transaction Type interface Transaction { action : TxAction ; date : string ; amount : number ; amount_out ?: number ; token_type : string ; status : TxStatus ; transaction_hash ?: string ; protocol ?: string ; new_token ?: string ; correlation_id ?: string ; apr ?: number ; block_number ?: number ; } enum TxAction { UNKNOWN = 'unknown' , APPROVE = 'approve' , DEPOSIT = 'deposit' , TRANSFER = 'transfer' , BRIDGE = 'bridge' , WITHDRAW = 'withdraw' , SWAP = 'swap' , REFILL_GAS_TANK = 'refill_gas_tank' , WRAP = 'wrap' , UNWRAP = 'unwrap' , FEE_TRANSFER = 'fee_transfer' , } enum TxStatus { UNKNOWN = 'unknown' , PENDING = 'pending' , APPROVED = 'approved' , CANCELLED = 'cancelled' , FAILED = 'failed' , }
Examples Async iteration
First N items
Specific page
import { Giza , Chain , SortOrder } from '@gizatech/agent-sdk' ; const giza = new Giza ({ chain: Chain . BASE }); const agent = giza . agent ( '0xYourSmartAccountAddress' ); for await ( const tx of agent . transactions ({ sort: SortOrder . DATE_DESC })) { console . log ( tx . date , tx . action , tx . amount , tx . token_type ); }
executions() Returns a paginator over the agent’s execution records. Each execution contains a list of transactions that were part of that run.
Signature executions ( options ?: PaginationOptions ): Paginator < ExecutionWithTransactionsDTO >
Parameters Optional pagination and sorting configuration. Items per page. Defaults to 20.
Sort order. Use SortOrder.DATE_ASC or SortOrder.DATE_DESC.
Returns Paginator<ExecutionWithTransactionsDTO>ExecutionWithTransactionsDTO Type interface ExecutionWithTransactionsDTO { id : string ; execution_plan : unknown ; execution_type : string ; status : ExecutionStatus ; created_at : string ; transactions : Transaction []; } enum ExecutionStatus { RUNNING = 'running' , FAILED = 'failed' , SUCCESS = 'success' , }
Examples const recentExecutions = await agent . executions ({ sort: SortOrder . DATE_DESC , }). first ( 10 ); for ( const exec of recentExecutions ) { console . log ( `Execution ${ exec . id } : ${ exec . status } ` ); console . log ( ` Type: ${ exec . execution_type } ` ); console . log ( ` Transactions: ${ exec . transactions . length } ` ); }
executionLogs() Returns a paginator over the logs for a specific execution.
Signature executionLogs ( executionId : string , options ?: PaginationOptions ): Paginator < LogDTO >
Parameters The execution ID to fetch logs for.
Optional pagination configuration. Items per page. Defaults to 20.
Returns Paginator<LogDTO>LogDTO Type interface LogDTO { type : string ; data : unknown ; }
Examples const executions = await agent . executions (). first ( 1 ); const latestExec = executions [ 0 ]; if ( latestExec ) { for await ( const log of agent . executionLogs ( latestExec . id )) { console . log ( `[ ${ log . type } ]` , log . data ); } }
logs() Returns a paginator over all logs for the agent, across all executions.
Signature logs ( options ?: PaginationOptions ): Paginator < LogDTO >
Parameters Optional pagination configuration. Items per page. Defaults to 20.
Returns Paginator<LogDTO>Examples const recentLogs = await agent . logs (). first ( 50 ); for ( const log of recentLogs ) { console . log ( `[ ${ log . type } ]` , JSON . stringify ( log . data )); }
All paginated methods accept the same options object.
interface PaginationOptions { limit ?: number ; sort ?: string ; } enum SortOrder { DATE_ASC = 'date_asc' , DATE_DESC = 'date_desc' , }
All paginated methods return a PaginatorPaginator reference for the full API including async iteration, .page(), and .first(). 
