Merge branch 'main' into sdk-new-release-updates

safe-global · Feb 27, 2025 · a9c29ba · a9c29ba
2 parents 58b38ac + 83e8715
commit a9c29ba
Show file tree

Hide file tree

Showing 49 changed files with 561 additions and 127 deletions.
diff --git a/.github/scripts/generateCodeExamples.ts b/.github/scripts/generateCodeExamples.ts
@@ -57,7 +57,20 @@ const repos = [
       '/app.json',
       '/.env-sample'
     ]
-  }
+  },
+  {
+    organization: '5afe',
+    repo: 'safe-ai-agent-tutorial',
+    destination: './examples/ai-agent',
+    branch: 'main',
+    files: [
+      '/agent.ts',
+      '/tools/safe.ts',
+      '/tools/prices.ts',
+      '/tools/math.ts',
+      '/.env.example'
+    ]
+  },
   // {
   //   organization: '5afe',
   //   repo: 'safe-7579-tutorial',

diff --git a/.github/styles/config/vocabularies/default/accept.txt b/.github/styles/config/vocabularies/default/accept.txt
@@ -10,6 +10,8 @@
 [Aa]urora
 [Aa]rbitrum
 [Aa]ccessor
+[Aa]uditability
+[Aa]utomation
 [Bb]ackend
 [Bb]inance
 [Bb]lockchain
@@ -22,10 +24,13 @@
 [Cc]omposable
 [Cc]onfig
 [Cc]rypto
+[Cc]ryptocurrency
 [Cc]ryptocurrencies
 [Dd]app
 [Dd]apps
 [Dd]elist
+[Dd]evnet
+[Dd]evnets
 [Ee]ndhint
 [Ee]rigon
 [Ee]thereum
@@ -34,15 +39,19 @@
 [Gg]elato
 [Gg]oerli
 [Gg]nosis
+[Gg]wei
+[Hh]ackathon
 [Ll]inea
 [Ll]inea
 [Ll]ogics
+[Ll][Ll][Mm]
 [Mm]ainnet
+[Mm]astercopy
 [Mm]iddleware
 [Mm]onerium
 [Mm]ultichain
 [Mm]ultisig
-[Mm]ultisend
+[Mm]ultiSend
 [Nn]extra
 [Nn]ginx
 [Oo]ffchain
@@ -62,8 +71,10 @@
 [Rr]elayers
 [Ss]epolia
 [Tt]estnet
+[Tt]estnets
 [Tt]rezor
 [Vv]alidator
+[Vv]alidators
 [Ww]hitepaper
 [Xx]code 
 A1
@@ -112,10 +123,10 @@ DAO
 DAOs
 Darwinia
 Degen
-Devnet
 DODOchain
 Dogechain
 EIP
+EIPs
 EOA
 EOAs
 ERC
@@ -160,7 +171,6 @@ keystore
 LUKSO
 Lightlink
 Lisk
-ledgerblue
 Mandala
 Mantle
 Masa
@@ -173,6 +183,7 @@ Moonbase
 Moonbeam
 Moonriver
 Mordor
+Nethermind
 Nova
 ngrok
 Nuxt
@@ -190,6 +201,7 @@ Prebuild
 Protofire
 PublicMint
 README
+READMEs
 REI
 RPC
 Relay Kit
@@ -244,6 +256,7 @@ UI Kit
 Uniswap
 Ultron
 USD
+UserOp
 Velas
 Venidium
 Viction
@@ -272,8 +285,11 @@ checksummed
 createTransaction
 const
 deployer
+eth_getLogs
 eSpace
 execTransaction
+ledgerblue
+ledgereth
 maxWidth
 mempool
 messageHash
@@ -282,11 +298,16 @@ npm
 onboarding
 onchain
 peaq
+pnpm
 pluggable
 polyfills
-precompile(?s)
+precompile
+precompiles
+preimage
 refetch
+refetches
 refetching
+rollups
 saltNonce
 stablecoin
 superset

diff --git a/assets/ai-agent-setup.png b/assets/ai-agent-setup.png
diff --git a/components/ApiReference/examples/arbitrum/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/arbitrum/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/aurora/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/aurora/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/avalanche/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/avalanche/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/...ents/ApiReference/examples/base-sepolia/-v1-user-operations-{user_operation_hash}--get.ts b/...ents/ApiReference/examples/base-sepolia/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/base/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/base/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/blast/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/blast/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/bsc/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/bsc/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/celo/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/celo/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/chiado/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/chiado/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/...ents/ApiReference/examples/gnosis-chain/-v1-user-operations-{user_operation_hash}--get.ts b/...ents/ApiReference/examples/gnosis-chain/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/linea/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/linea/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/mainnet/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/mainnet/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/mantle/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/mantle/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/optimism/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/optimism/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/polygon/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/polygon/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/scroll/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/scroll/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/sepolia/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/sepolia/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/...onents/ApiReference/examples/worldchain/-v1-user-operations-{user_operation_hash}--get.ts b/...onents/ApiReference/examples/worldchain/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/xlayer/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/xlayer/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/zkevm/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/zkevm/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/components/ApiReference/examples/zksync/-v1-user-operations-{user_operation_hash}--get.ts b/components/ApiReference/examples/zksync/-v1-user-operations-{user_operation_hash}--get.ts
@@ -3,7 +3,7 @@ import { Safe4337Pack } from '@safe-global/relay-kit'
 const safe4337Pack = await Safe4337Pack.init({
   provider: 'https://eth-sepolia.public.blastapi.io',
   signer: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
-  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?apikey=${PIMLICO_API_KEY}`,
+  bundlerUrl: `https://api.pimlico.io/v1/sepolia/rpc?add_balance_override&apikey=${PIMLICO_API_KEY}`,
   options: {
     safeAddress: '0x97566B1eCaCd321736F183117C26ACe1b72F4a1b'
   }

diff --git a/examples/ai-agent/.env.example b/examples/ai-agent/.env.example
@@ -0,0 +1,10 @@
+AGENT_PRIVATE_KEY="0x..."
+AGENT_ADDRESS="0x..."
+
+# Optional:
+OPENAI_API_KEY="sk-..."
+LANGCHAIN_API_KEY="lsv2_..."
+LANGCHAIN_CALLBACKS_BACKGROUND="true"
+LANGCHAIN_TRACING_V2="true"
+LANGCHAIN_PROJECT="Safe Agent Tutorial"
+