Sdk new release updates

pages/reference-sdk-api-kit/_meta.json

@@ -11,7 +11,7 @@
   "constructor": "constructor",
   "getserviceinfo": "getServiceInfo",
   "getservicesingletonsinfo": "getServiceSingletonsInfo",
-  "decodeddata": "decodedData",
+  "decodedata": "decodeData",
   "getsafesbyowner": "getSafesByOwner",
   "getsafesbymodule": "getSafesByModule",
   "gettransaction": "getTransaction",
@@ -37,6 +37,7 @@
   "addmessage": "addMessage",
   "addmessagesignature": "addMessageSignature",
   "getsafeoperationsbyaddress": "getSafeOperationsByAddress",
+  "getpendingsafeoperations": "getPendingSafeOperations",
   "getsafeoperation": "getSafeOperation",
   "addsafeoperation": "addSafeOperation",
   "getsafeoperationconfirmations": "getSafeOperationConfirmations",

pages/reference-sdk-api-kit/decodeddata.mdx → pages/reference-sdk-api-kit/decodedata.mdx

@@ -33,10 +33,17 @@ Decodes the specified Safe transaction data.
 
 ## Returns
 
-`Promise<any>`
+`Promise<DataDecoded>`
 
 The transaction data decoded.
 
+```typescript
+type DataDecoded = {
+  readonly method: string
+  readonly parameters: DecodedParameters[]
+}
+```
+
 ## Parameters
 
 ### `data`
@@ -45,8 +52,19 @@ The transaction data decoded.
 
 The Safe transaction data to decode.
 
-```typescript focus=2
+```typescript
+const decodedData = await apiKit.decodeData('0x...')
+```
+
+### `to` (Optional)
+
+- **Type:** `string`
+
+The address of the receiving contract. If provided, the decoded data will be more accurate, as in case of an ABI collision the Safe Transaction Service would know which ABI to use
+
+```typescript
 const decodedData = await apiKit.decodeData(
+  '0x...',
   '0x...'
 )
 ```

pages/reference-sdk-api-kit/getincomingtransactions.mdx

@@ -14,8 +14,13 @@ Returns the history of incoming transactions of a Safe account.
     import { apiKit } from './setup.ts'
 
     const safeAddress = '0x...'
+    const options = {
+      _from: '0x...',
+      limit: 10,
+      offset: 10
+    }
 
-    const incomingTxs = await apiKit.getIncomingTransactions(safeAddress)
+    const incomingTxs = await apiKit.getIncomingTransactions(safeAddress, options)
     ```
   </Tabs.Tab>
   <Tabs.Tab>
@@ -50,3 +55,21 @@ const incomingTxs = await apiKit.getIncomingTransactions(
   '0x...'
 )
 ```
+
+### `options.from` (Optional)
+
+- **Type:** `string`
+
+The transaction sender address.
+
+### `options.limit` (Optional)
+
+- **Type:** `number`
+
+The number of results to return per page.
+
+### `options.offset` (Optional)
+
+- **Type:** `number`
+
+The initial index from which to return the results.

pages/reference-sdk-api-kit/getmoduletransactions.mdx

@@ -14,10 +14,13 @@ Returns the history of module transactions of a Safe account.
     import { apiKit } from './setup.ts'
 
     const safeAddress = '0x...'
+    const options = {
+      module: '0x...',
+      limit: 10,
+      offset: 10
+    }
 
-    const moduleTxs = await apiKit.getModuleTransactions(
-      safeAddress
-    )
+    const moduleTxs = await apiKit.getModuleTransactions(safeAddress, options)
     ```
   </Tabs.Tab>
   <Tabs.Tab>
@@ -52,3 +55,21 @@ const moduleTxs = await apiKit.getModuleTransactions(
   '0x...'
 )
 ```
+
+### `options.module` (Optional)
+
+- **Type:** `string`
+
+The module to get the transactions from.
+
+### `options.limit` (Optional)
+
+- **Type:** `number`
+
+The number of results to return per page.
+
+### `options.offset` (Optional)
+
+- **Type:** `number`
+
+The initial index from which to return the results.

pages/reference-sdk-api-kit/getmultisigtransactions.mdx

@@ -14,10 +14,15 @@ Returns the history of multi-signature transactions of a Safe account.
     import { apiKit } from './setup.ts'
 
     const safeAddress = '0x...'
-
-    const multisigTxs = await apiKit.getMultisigTransactions(
-      safeAddress
-    )
+    const options = {
+      executed: true,
+      nonce: '0x...',
+      ordering: 'created',
+      limit: 10,
+      offset: 10
+    }
+
+    const multisigTxs = await apiKit.getMultisigTransactions(safeAddress, options)
     ```
   </Tabs.Tab>
   <Tabs.Tab>
@@ -52,3 +57,33 @@ const multisigTxs = await apiKit.getMultisigTransactions(
   '0x...'
 )
 ```
+
+### `options.executed` (Optional)
+
+- **Type:** `boolean`
+
+Filter the executed transactions if `true`.
+
+### `options.nonce` (Optional)
+
+- **Type:** `string`
+
+The nonce used to return the results.
+
+### `options.ordering` (Optional)
+
+- **Type:** `string`
+
+The field used to sort the results.
+
+### `options.limit` (Optional)
+
+- **Type:** `number`
+
+The number of results to return per page.
+
+### `options.offset` (Optional)
+
+- **Type:** `number`
+
+The initial index from which to return the results.

pages/reference-sdk-api-kit/getpendingsafeoperations.mdx

@@ -0,0 +1,106 @@
+import { Tabs } from 'nextra/components'
+
+# `getPendingSafeOperations`
+
+Returns the list of Safe operations which are pending to be executed through a bundler.
+
+## Usage
+
+{/* <!-- vale off --> */}
+
+<Tabs items={['example.ts', 'setup.ts']}>
+  <Tabs.Tab>
+    ```typescript
+    import { GetSafeOperationListProps } from '@safe-global/api-kit'
+    import { apiKit } from './setup.ts'
+
+    const safeAddress = '0x...'
+    const options: GetPendingSafeOperationListOptions = {
+      ordering: 'created', // Optional
+      limit: '10', // Optional
+      offset: '50' // Optional
+    }
+
+    const safeOperationsResponse = await apiKit.getPendingSafeOperations(safeAddress, options)
+    ```
+  </Tabs.Tab>
+  <Tabs.Tab>
+    ```typescript
+    import SafeApiKit from '@safe-global/api-kit'
+
+    export const apiKit = new SafeApiKit({
+      chainId: 1n, // Mainnet
+    })
+    ```
+  </Tabs.Tab>
+</Tabs>
+
+{/* <!-- vale on --> */}
+
+## Returns
+
+`Promise<GetSafeOperationListResponse>`
+
+The paginated list of Safe operations.
+
+## Parameters
+
+### `safeAddress`
+
+- **Type:** `string`
+
+The Safe address.
+
+```typescript focus=2
+const safeOperationsResponse = await apiKit.getPendingSafeOperations({
+  safeAddress: '0x...'
+})
+```
+
+### `options.ordering` (Optional)
+
+- **Type:** `string`
+- **Default:** `-user_operation__nonce`
+
+The field used when ordering the results.
+
+Can be one of: `-user_operation__nonce`, `-created`, `created`.
+
+```typescript focus=4
+const safeOperationsResponse = await apiKit.getPendingSafeOperations(
+  {
+    safeAddress: '0x...',
+    ordering: 'created'
+  }
+)
+```
+
+### `options.limit` (Optional)
+
+- **Type:** `number`
+
+The number of results to return per page.
+
+```typescript focus=4
+const safeOperationsResponse = await apiKit.getPendingSafeOperations(
+  {
+    safeAddress: '0x...',
+    limit: 10
+  }
+)
+```
+
+### `options.offset` (Optional)
+
+- **Type:** `number`
+
+The initial index from which to return the results.
+
+```typescript focus=4
+const safeOperationsResponse = await apiKit.getPendingSafeOperations(
+  {
+    safeAddress: '0x...',
+    offset: 50
+  }
+)
+```

pages/reference-sdk-api-kit/getpendingtransactions.mdx

@@ -13,14 +13,16 @@ Returns the list of multi-signature transactions that are waiting for the confir
     ```typescript
     import { apiKit } from './setup.ts'
 
-    const safeAddress = '0x...'
-
-    const currentNonce = 10
-
-    const pendingTxs = await apiKit.getPendingTransactions(
-      safeAddress,
-      currentNonce // Optional
-    )
+    const safeAddress = '0x...'      
+    const options = {
+      currentNonce: 0,
+      hasConfirmations: true,
+      ordering: 'created',
+      limit: 10,
+      offset: 10
+    }
+
+    const pendingTxs = await apiKit.getPendingTransactions(safeAddress, options)      
     ```
   </Tabs.Tab>
   <Tabs.Tab>
@@ -56,15 +58,32 @@ const pendingTxs = await apiKit.getPendingTransactions(
 )
 ```
 
-### `currentNonce` (Optional)
+### `options.currentNonce` (Optional)
 
 - **Type:** `number`
 
 The current nonce of the Safe.
 
-```typescript focus=3
-const pendingTxs = await apiKit.getPendingTransactions(
-  '0x...',
-  10
-)
-```
+### `options.hasConfirmations` (Optional)
+
+- **Type:** `boolean`
+
+Filter transactions with al least one confirmation.
+
+### `options.ordering` (Optional)
+
+- **Type:** `string`
+
+The field used to sort the results.
+
+### `options.limit` (Optional)
+
+- **Type:** `number`
+
+The number of results to return per page.
+
+### `options.offset` (Optional)
+
+- **Type:** `number`
+
+The initial index from which to return the results.