Multisend Decoder

A tool to decode Safe Wallet (v1.3) multisend transactions.

Description

This tool decodes multisend bytes for a Safe Wallet version 1.3, showing the individual transactions in a readable format. Each transaction is decoded according to the following format:

| Type (1 byte) | Operation (1 byte) | To (20 bytes) | Value (32 bytes) | Data Length (32 bytes) | Data (variable length) |

The decoder extracts each transaction and provides detailed information about:

• Operation type (Call or DelegateCall)
• Target address
• Value (in wei)
• Transaction data
• Additional context for specific transaction types (e.g., token approvals)

Installation

Prerequisites

• Node.js (v14 or higher)
• npm (v6 or higher)
• Docker (optional, for containerized usage)

Option 1: Local Installation

1. Clone this repository:

   git clone https://github.com/reown-com/safe-decoder.git
   cd safe-decoder

2. Install dependencies:

   npm install

Option 2: Docker Installation

Build Locally

Alternatively, you can build the Docker image locally:

1. Clone this repository:

   git clone https://github.com/reown-com/safe-decoder.git
   cd safe-decoder

2. Build the Docker image:

   docker build -t safe-decoder .

Usage

Using Node.js Directly

Run the script with your multisend transaction data:

node decode.js "0x<your-multisend-data>"

Example:

node decode.js "0x00ef4461891dfb3ac8572ccf7c794664a8dd92794500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044095ea7b3000000000000000000000000f368f535e329c6d08dff0d4b2da961c4e7f3fcaf000000000000000000000000000000000000000000000599223bbba52fcbf4a100f368f535e329c6d08dff0d4b2da961c4e7f3fcaf00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044097cd2320000000000000000000000000000000000000000000000000000000067bfab00000000000000000000000000000000000000000000000599223bbba52fcbf4a1"

Using Docker

Run the Docker container with your multisend transaction data:

# If you pulled from Docker Hub
docker run reowncom/safe-decoder "0x<your-multisend-data>"

# If you pulled from GitHub Container Registry
docker run ghcr.io/reown-com/safe-decoder "0x<your-multisend-data>"

# If you built locally
docker run safe-decoder "0x<your-multisend-data>"

Example:

docker run reowncom/safe-decoder "0x00ef4461891dfb3ac8572ccf7c794664a8dd92794500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044095ea7b3000000000000000000000000f368f535e329c6d08dff0d4b2da961c4e7f3fcaf000000000000000000000000000000000000000000000599223bbba52fcbf4a100f368f535e329c6d08dff0d4b2da961c4e7f3fcaf00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044097cd2320000000000000000000000000000000000000000000000000000000067bfab00000000000000000000000000000000000000000000000599223bbba52fcbf4a1"

Using Docker with a Specific Version

If you want to use a specific version:

docker run reowncom/safe-decoder:1.0.0 "0x<your-multisend-data>"

Saving Output to a File

You can save the output to a file using standard output redirection:

# Using Node.js
node decode.js "0x<your-multisend-data>" > output.txt

# Using Docker
docker run reowncom/safe-decoder "0x<your-multisend-data>" > output.txt

Example Output

Decoded 2 transactions:

Transaction 1:
Operation: Call
To: 0xef4461891dfb3ac8572ccf7c794664a8dd927945
Value: 0
Data: 0x095ea7b3000000000000000000000000f368f535e329c6d08dff0d4b2da961c4e7f3fcaf000000000000000000000000000000000000000000000599223bbba52fcbf4a1
Spender: 0xF368F535e329c6d08DFf0d4b2dA961C4e7F3fCAF
Amount: 26436651029164848837793

Transaction 2:
Operation: Call
To: 0xf368f535e329c6d08dff0d4b2da961c4e7f3fcaf
Value: 0
Data: 0x097cd2320000000000000000000000000000000000000000000000000000000067bfab00000000000000000000000000000000000000000000000599223bbba52fcbf4a1
Contract: 0xf368f535e329c6d08dff0d4b2da961c4e7f3fcaf

Development

Modifying the Script

The main script is in decode.js. If you want to add support for decoding additional transaction types or enhance the output format, modify this file.

Building a New Docker Image

After making changes to the script, rebuild the Docker image:

docker build -t safe-decoder:latest .

You can also tag the image with a specific version:

docker tag safe-decoder:latest safe-decoder:1.0.1

Publishing to Docker Repositories

To make the image available to your teammates, you can push it to a Docker repository:

Docker Hub

# Log in to Docker Hub
docker login

# Tag the image (if not already done)
docker tag safe-decoder:latest yourusername/safe-decoder:latest

# Push the image
docker push yourusername/safe-decoder:latest

GitHub Container Registry

# Log in to GitHub Container Registry
echo YOUR_PAT | docker login ghcr.io -u YOUR_GITHUB_USERNAME --password-stdin

# Tag the image (if not already done)
docker tag safe-decoder:latest ghcr.io/yourusername/safe-decoder:latest

# Push the image
docker push ghcr.io/yourusername/safe-decoder:latest

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.