Skip to content
9 changes: 5 additions & 4 deletions SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,15 +73,16 @@
* [Usage](sdk/bridge-modules/bridge-usdt0-evm/usage.md)
* [Configuration](sdk/bridge-modules/bridge-usdt0-evm/configuration.md)
* [API Reference](sdk/bridge-modules/bridge-usdt0-evm/api-reference.md)
<!-- * [bridge-usdt0-ton](sdk/bridge-modules/bridge-usdt0-ton/README.md)
* [Usage](sdk/bridge-modules/bridge-usdt0-ton/usage.md)
* [Configuration](sdk/bridge-modules/bridge-usdt0-ton/configuration.md)
* [API Reference](sdk/bridge-modules/bridge-usdt0-ton/api-reference.md) -->
* [Lending Modules](sdk/lending-modules/README.md)
* [lending-aave-evm](sdk/lending-modules/lending-aave-evm/README.md)
* [Usage](sdk/lending-modules/lending-aave-evm/usage.md)
* [Configuration](sdk/lending-modules/lending-aave-evm/configuration.md)
* [API Reference](sdk/lending-modules/lending-aave-evm/api-reference.md)
* [Multisig Modules](sdk/multisig-modules/README.md)
* [multisig-safe](sdk/multisig-modules/protocol-multisig-safe/README.md)
* [Usage](sdk/multisig-modules/protocol-multisig-safe/usage.md)
* [Configuration](sdk/multisig-modules/protocol-multisig-safe/configuration.md)
* [API Reference](sdk/multisig-modules/protocol-multisig-safe/api-reference.md)
* [Fiat Modules](sdk/fiat-modules/README.md)
* [fiat-moonpay](sdk/fiat-modules/fiat-moonpay/README.md)
* [Usage](sdk/fiat-modules/fiat-moonpay/usage.md)
Expand Down
14 changes: 12 additions & 2 deletions sdk/get-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ It is built on some core principles: **self-custodial and stateless** (private k
* **Multi-Chain Support**: Bitcoin, Ethereum, TON, TRON, Solana, Spark, and more
* **Account Abstraction**: Gasless transactions on supported chains
* **DeFi Integration**: Plug-in support for swaps, bridges, and lending protocols
* **Multisig Wallets**: Safe Protocol integration for multi-party wallet control
* **Extensible Design**: Add custom modules for new blockchains or protocols

***
Expand All @@ -46,7 +47,7 @@ New functionality is added through modules rather than modifying core code. Also

#### Module Types

WDK modules are organized into five main categories, each serving a specific purpose in the blockchain application stack:
WDK modules are organized into six main categories, each serving a specific purpose in the blockchain application stack:

<table data-view="cards">
<thead>
Expand Down Expand Up @@ -75,6 +76,15 @@ WDK modules are organized into five main categories, each serving a specific pur
<a href="./wallet-modules/README.md">Wallet Modules</a>
</td>
</tr>
<tr>
<td>
<strong>Multisig</strong>
</td>
<td>Multi-party wallet management</td>
<td>
<a href="./multisig-modules/README.md">Multisig Modules</a>
</td>
</tr>
<tr>
<td>
<strong>Swap</strong>
Expand Down Expand Up @@ -355,4 +365,4 @@ Ready to start building? Choose your development environment:

### Need Help?

{% include "../.gitbook/includes/support-cards.md" %}
{% include "../.gitbook/includes/support-cards.md" %}
69 changes: 69 additions & 0 deletions sdk/multisig-modules/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
# Multisig Modules

Overview of WDK Multisig Modules

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Overview of WDK Multisig Modules
This document provides an overview of the WDK Multisig Modules.


The Wallet Development Kit (WDK) provides multisig modules that enable secure multi-party wallet management. These modules allow multiple signers to control shared wallets with customizable approval thresholds.

## Why Multisig?

Multisig (multi-signature) wallets require multiple parties to approve transactions before execution. This provides:

* **Enhanced Security**: No single point of failure - multiple keys required
* **Team Control**: Perfect for companies, DAOs, and shared treasuries
* **Approval Workflows**: Configurable thresholds
* **Accountability**: Full audit trail of who approved what

## Available Modules

| Module | Blockchain | Status | Documentation |
| --- | --- | --- | --- |
| @tetherto/wdk-protocol-multisig-safe | EVM | ✅ Ready | [Documentation](protocol-multisig-safe/README.md) |

## Module Features

### Standard Features

All multisig modules share these core features:

* **Multi-Owner Management**: Add, remove, and swap owners
* **Threshold Configuration**: Set required approval count
* **Propose/Approve/Execute**: Standard multisig workflow
* **Transaction Tracking**: View pending and historical transactions
* **Message Signing**: Sign and verify messages with multisig approval (EIP-1271)

### Account Abstraction Features

Modules with ERC-4337 support include:

* **Gasless Transactions**: Pay fees in ERC-20 tokens (e.g., USDT)
* **Sponsored Mode**: Completely gas-free transactions
* **Bundled Operations**: Multiple approvals in single transaction

## Getting Started

To get started with WDK multisig modules, follow these steps:

1. Get up and running quickly with our [Quick Start Guide](/start-building/nodejs-bare-quickstart)
2. Choose the module that best fits your needs from the table above
3. Check specific documentation for the module you wish to use
Comment on lines +46 to +48

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Get up and running quickly with our [Quick Start Guide](/start-building/nodejs-bare-quickstart)
2. Choose the module that best fits your needs from the table above
3. Check specific documentation for the module you wish to use
1. Get up and running quickly with our [Quick Start Guide](/start-building/nodejs-bare-quickstart).
2. Choose the module that best fits your needs from the table above.
3. Check specific documentation for the module you wish to use.


## Next Steps

**Protocol Multisig Safe**

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ihsraham could you add links to these?


Safe Protocol multisig with ERC-4337 account abstraction

**Node.js Quickstart**

Get started with WDK in a Node.js environment

**Concepts**

Learn about key concepts like Account Abstraction

---

### Need Help?


{% include "../../.gitbook/includes/support-cards.md" %}
53 changes: 53 additions & 0 deletions sdk/multisig-modules/protocol-multisig-safe/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
# protocol-multisig-safe

Overview of the @tetherto/wdk-protocol-multisig-safe module

A simple and secure package to manage Safe Protocol multisig wallets with ERC-4337 account abstraction for EVM-compatible blockchains. This package provides a clean API for creating, managing, and interacting with multisig wallets using BIP-39 seed phrases and the Safe smart contract infrastructure.

## Features

* **Safe Protocol Integration**: Full support for Safe (formerly Gnosis Safe) multisig wallets
* **ERC-4337 Account Abstraction**: Gasless transactions via paymasters and bundlers
* **Paymaster Modes**: Support for both ERC-20 paymaster and sponsored (gasless) modes
* **Per-Transaction Override**: Switch between ERC-20 and sponsored mode per transaction
* **Multi-Owner Management**: Add, remove, swap owners and change threshold
* **Propose/Approve/Execute**: Standard multisig transaction workflow
* **Message Signing**: EIP-191 compliant multisig message signing
* **Deterministic Addresses**: Predictable Safe addresses from owner configuration
* **Auto-Execute**: Automatically execute transactions when threshold is met
* **TypeScript Support**: Full TypeScript definitions included
* **Memory Safety**: Secure private key management with memory-safe implementation

## Supported Networks

This package works with any EVM-compatible network that supports:

* **Ethereum**: Mainnet, Sepolia
* **Polygon**: Mainnet, Mumbai
* **Arbitrum**: One, Nova
* **Optimism**: Mainnet, Goerli
* **And more**: Any chain with Safe Protocol and ERC-4337 infrastructure

## Next Steps

**Node.js Quickstart**

Get started with WDK in a Node.js environment

**WDK Multisig Safe Configuration**

Get started with WDK's Multisig Safe configuration

**WDK Multisig Safe API**

Get started with WDK's Multisig Safe API

**WDK Multisig Safe Usage**

Get started with WDK's Multisig Safe usage

---

### Need Help?

{% include "../../../.gitbook/includes/support-cards.md" %}
Loading