> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peaq.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi-Sig

**Multi-signature** (multi-sig) wallets provide an added layer of security and decentralization by requiring **multiple approvals** for transactions.
[Gnosis Safe](https://docs.safe.global/sdk/overview) is a widely used and trusted solution for implementing multi-sig wallets on EVM-compatible blockchains like the peaq network. This
guide walks you through **creating a multi-sig wallet programmatically** using Gnosis Safe contracts and demonstrates some basic functions such as adding owners and executing transactions.

## Prerequisites

* Basic knowledge of blockchain development and JavaScript/TypeScript.
* Familiar with interacting with smart contracts using `ethers.js`.
* Have access to a deployed instance of Gnosis Safe contracts on the peaq network or are able to deploy them yourself.
* Have an RPC URL for the peaq network.
* Have private keys for multiple signers to interact with the wallet.

### Instructions

### 1. Set Up Your Environment

* Install the necessary dependencies:

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
npm install ethers @gnosis.pm/safe-core-sdk @gnosis.pm/safe-ethers-lib dotenv
```

* Set ESM Module:
  Add the following to your `package.json` to alllow for ESM modules.

```javascript theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
"type": "module",
```

* Configure a `.env` file with the following variables:

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
RPC_URL=https://quicknode.peaq.xyz
PRIVATE_KEY=your_private_key_here
```

### 2. Connect to the Peaq Network

Import dependencies and initialize the provider and signer:

```javascript theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
import { ethers } from 'ethers';
import Safe from '@gnosis.pm/safe-core-sdk';
import SafeEthersLib from '@gnosis.pm/safe-ethers-lib';
import dotenv from 'dotenv';

dotenv.config();

const provider = new ethers.JsonRpcProvider(process.env.RPC_URL);
const signer = new ethers.Wallet(process.env.PRIVATE_KEY, provider);
```

### 3. Deploy a New Multi-Sig Wallet

Use the Gnosis Safe SDK to create a new multi-sig wallet:

```javascript theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
const createSafe = async () => {
    const safeFactory = await Safe.SafeFactory.create({
        ethAdapter: new SafeEthersLib.EthersAdapter({
            ethers,
            signer
        }),
    });

    const owners = [
        '0xAddress1',
        '0xAddress2',
        '0xAddress3'
    ];
    const threshold = 2; // Number of approvals required
    const safeAccountConfig = { owners, threshold };

    const safe = await safeFactory.deploySafe({ safeAccountConfig });
    console.log(`Multi-sig wallet deployed at: ${safe.getAddress()}`);
    return safe;
};

createSafe();
```

### 4. Add an Owner

Propose a transaction to add a new owner:

```javascript theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
const addOwner = async (safeAddress, newOwner, safe) => {
    const safeTransaction = await safe.createAddOwnerTx({
        ownerAddress: newOwner,
        threshold: 2,
    });

    const txHash = await safe.executeTransaction(safeTransaction);
    console.log(`Transaction hash: ${txHash}`);
};

addOwner(safe.getAddress(), '0xNewOwnerAddress', safe);
```

### **5. Execute a Transaction**

Propose and execute a basic transaction (e.g., sending PEAQ):

```javascript theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
const executeTransaction = async (safeAddress, recipient, amount) => {
    const safe = await Safe.default.create({
        ethAdapter: new SafeEthersLib.EthersAdapter({ ethers, signer }),
        safeAddress,
    });

    const safeTransactionData = {
        to: recipient,
        value: ethers.parseEther(amount), // Amount in PEAQ
        data: '0x',
    };

    const safeTransaction = await safe.createTransaction({ safeTransactionData });
    const txHash = await safe.executeTransaction(safeTransaction);
    console.log(`Transaction executed. Hash: ${txHash}`);
};

executeTransaction(safe.getAddress(), '0xRecipientAddress', '0.1');
```

## Summary

Using **Gnosis Safe contracts** on the peaq network allows you to leverage the security of multi-signature wallets for DePIN projects. This guide demonstrated how to
programmatically create a wallet, manage owners, and execute transactions. With these basics, you can **secure** your **assets** and **operations** on the peaq network with
confidence. Expand further by integrating Gnosis Safe with front-end interfaces or automated scripts for enhanced usability and functionality.