# Safe Account Abstraction

The Safe{Core} Account Abstraction (AA) SDK aims to bring Account Abstraction to life by integrating Safe with Gelato Relay. This SDK helps developers to abstract the complexity of setting up a smart contract account.

**Account Abstraction Kit** The AA kit helps user ot create predeterministic smart contract wallets and execute gasless transactions with the Gelato Relay. The safe will only be deployed when the first transaction is sent.

**Protocol Kit** The Protocol Kit helps interact with the Safe contracts. It enables the creation of new Safe accounts, updating their configuration, and signing and executing transactions, among other features.

**Relay Kit** The Relay Kit relays Safe transactions, allowing you to get them sponsored by a third party or paid with any supported ERC-20 token.

## Safe AA SDKs

As part of the Gelato Raas AA offerings, we have deployed a custom safe-sdk creating following packages

| Package           | SDK                                 |
| ----------------- | ----------------------------------- |
| Safe Protocol Kit | gelato-raas-protocol-kit            |
| Safe AA Kit       | gelato-raas-account-abstraction-kit |
| Safe Relay Kit    | gelato-raas-relay-kit               |

This project showcase how to send Gasless Transactions through a Safe sponsoring the gas with [1Balance](https://docs.gelato.network/developer-services/1balance)

In following examples examples, it will be called the `increment()` method on this simple counter contract deployed on unreal <https://unreal.blockscout.com/address/0xEEeBe2F778AA186e88dCf2FEb8f8231565769C27>

## Quick Start

1. Clone the [safe](https://github.com/gelatodigital/gelato-raas-aa) repo
2. Install project dependencies:

```
yarn install
```

in the package.json we have already included gelato-raas-protocol-kit, gelato-raas-account-abstraction-kit and gelato-raas-relay-kit

```shell
  "gelato-raas-account-abstraction-kit": "^1.3.7",
  "gelato-raas-protocol-kit": "^1.3.6",
  "gelato-raas-relay-kit": "^1.3.7"
```

3. Create a .env file with your private config:

```shell
cp .env.example .env
```

You will need to input your Private Key **PK** and **GELATO\_RELAY\_API\_KEY** for sponsored transactions, you can get it at <https://app.gelato.network>

4. Call the method:

* Using 1Balance

  ```tyescript
   yarn aa1Balance
  ```

### Using 1Balance

```typescript
const safeTransactionData: MetaTransactionData = {
  to: targetAddress,
  data: nftContract.interface.encodeFunctionData("increment", []),
  value: "0",
  operation: OperationType.Call,
};

const safeAccountAbstraction = new AccountAbstraction(signer);
const sdkConfig: AccountAbstractionConfig = {
  relayPack,
};
await safeAccountAbstraction.init(sdkConfig);

const txConfig = {
  TO: targetAddress,
  DATA: safeTransactionData.data,
  VALUE: "0",
  // Options:
  GAS_LIMIT: gasLimit,
};

const predictedSafeAddress = await safeAccountAbstraction.getSafeAddress();
console.log({ predictedSafeAddress });

const isSafeDeployed = await safeAccountAbstraction.isSafeDeployed();
console.log({ isSafeDeployed });

const safeTransactions: MetaTransactionData[] = [
  {
    to: txConfig.TO,
    data: txConfig.DATA,
    value: txConfig.VALUE,
    operation: OperationType.Call,
  },
];
const options: MetaTransactionOptions = {
  gasLimit: txConfig.GAS_LIMIT,
  isSponsored: true,
};

const response = await safeAccountAbstraction.relayTransaction(
  safeTransactions,
  options
);
console.log(`https://relay.gelato.digital/tasks/status/${response} `);
```

### **Output**

```shell
$ ts-node src/aa-safe-gasless/aa1Balance.ts
{ predictedSafeAddress: '0x68D60c586763879c6614e2eFA709cCae708203c4' }
{ isSafeDeployed: true }
https://relay.gelato.digital/tasks/status/0xc34f62e1b057b298c144c79b3cc16e4e24bc2b1e91ce5cd7660f9b8c1791be91
```

## UI integration together with Web3Auth

Please visit the deployed react mini site on <https://gelato-raas-aa.web.app/?network=unreal> with a live implementation of web3Auth and safe on unreal

<figure><img src="/files/nJvFOJngHtgrbsUtvX9S" alt=""><figcaption></figcaption></figure>

The code can be found at <https://github.com/gelatodigital/gelato-raas-aa-ui>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.re.al/services/account-abstraction/safe-account-abstraction.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.