-
-
-Use the network selector and switch to zKatana network, or allow MetaMask to switch to zKatana network for you.
-
-
-
-
-
-
-
-Click on the Bridge tab on the left-hand side. Ensure Sepolia is selected as Bridge source, and zKatana is selected as destination. After you have entered the amount of ETH to transfer, press the Confirm button.
-
-
-
-
-
-
-
-Sign the MetaMask transaction.
-
-:::note
-Once the transaction shows as confirmed on the MetaMask Activity tab, it will take approximately 5-10 minutes for the Astar Portal and MetaMask to update your balance on the zKatana network side.
-:::
-
-
-
-
-
-
-
-
-
-
- You should now see the bridged ETH within MetaMask for use on Astar zkEVM.
diff --git a/docs/build/zkEVM/canonical-zkevm-contracts.md b/docs/build/zkEVM/canonical-zkevm-contracts.md
index c64daff6bdb..b4f74ee9512 100644
--- a/docs/build/zkEVM/canonical-zkevm-contracts.md
+++ b/docs/build/zkEVM/canonical-zkevm-contracts.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 10
+sidebar_position: 2
title: Canonical Contracts
---
import Tabs from '@theme/Tabs';
@@ -16,7 +16,7 @@ Wrapped ETH (wETH) on Astar zkEVM contract address is [`0xE9CC37904875B459Fa5D0F
### Bridged Tokens
-
+
| Contract Name | Source | Contract Address |
| ---------------------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
@@ -31,16 +31,12 @@ Wrapped ETH (wETH) on Astar zkEVM contract address is [`0xE9CC37904875B459Fa5D0F
-
-coming soon...
-
-
## Polygon CDK Validium Specific Contracts
-
+
| Contract Name | Network | Contract Address |
| ---------------------------- | ---------------- | -------------------------------------------- |
@@ -55,21 +51,13 @@ coming soon...
| PolygonZkEVMBridge | L2 (Astar zkEVM) | `0x2a3dd3eb832af982ec71669e178424b10dca2ede` |
| PolygonZkEVMGlobalExitRootL2 | L2 (Astar zkEVM) | `0xa40d5f56745a118d0906a34e69aec8c0db1cb8fa` |
-
-coming soon...
-
-
More documentation about the Polygon CDK Validium contracts can be found in the [cdk-validium-contracts GitHub repository](https://github.com/0xPolygon/cdk-validium-contracts)
-## Ethereum Specific Precompiles
-
-TODO - refer to a link in CDK Docs which covers which precompiles are available for CDK
-
### LayerZero Bridge
-
+
| Contract Name | Network | Contract Address ( Endpoint ) | endpointId |
| ---------------------------- | ------------------------------|--------------------------------------------- |--------------|
@@ -80,10 +68,6 @@ TODO - refer to a link in CDK Docs which covers which precompiles are available
| LayerZero OFT ASTR | L2 (Astar zkEVM) | `0xdf41220C7e322bFEF933D85D01821ad277f90172` | - |
| LayerZero NativeOFT ASTR | L1 (Astar EVM (Substrate)) | `0xdf41220C7e322bFEF933D85D01821ad277f90172` | - |
-
-| LayerZero endpoint V1 | L2 (Astar zKyoto) | `0x6098e96a28E02f27B1e6BD381f870F1C8Bd169d3` | 10266 |
-| LayerZero endpoint V2 | L2 (Astar zKyoto) | `0x6EDCE65403992e310A62460808c4b910D972f10f` | 40266 |
-
More documentation about the LayerZero Bridge can be found in [this section](/docs/build/zkEVM/integrations/bridges-relays/AstarEVM-zkEVM.md)
diff --git a/docs/build/zkEVM/fee.md b/docs/build/zkEVM/fee.md
index 6e841e88329..e5a2f650a40 100644
--- a/docs/build/zkEVM/fee.md
+++ b/docs/build/zkEVM/fee.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 7
+sidebar_position: 3
title: Astar zkEVM Fee Calculation
sidebar_label: Fee Calculation
---
diff --git a/docs/build/zkEVM/index.md b/docs/build/zkEVM/index.md
index fdf7f1487b1..29ec912b1a4 100644
--- a/docs/build/zkEVM/index.md
+++ b/docs/build/zkEVM/index.md
@@ -5,7 +5,7 @@
Astar zkEVM is an Ethereum Layer-2 scaling solution leveraging Polygon's Chain Development Kit and cutting edge zero-knowledge cryptography to enable off-chain transaction execution, with finality and security guarantees provided by Ethereum. In coordination with our key partners, Astar zkEVM is well-positioned to take advantage of the extensive developer base and well-established toolset existing in the Ethereum ecosystem, and boasts the following key features:
- **Lower Transaction Fees compared to Ethereum** - Due to the transaction batching, as explained above.
-- **Full EVM-equivalence** - Not only EVM compatibility; Equivalence. Smart contracts that work on Ethereum also work on Astar zkEVM. See the [smart contract section](/docs/build/zkEVM/smart-contracts/) for more information.
+- **Full EVM-equivalence** - Not only EVM compatibility; Equivalence. Smart contracts that work on Ethereum also work on Astar zkEVM.
- **Native Account Abstraction** - The Astar zkEVM provides native features designed to revolutionize the end-user experience, and make it seamless. See the [Account Abstraction section](/docs/build/zkEVM/integrations/account-abstraction/) to learn more about how to refine the end-user experience.
- **Recognized Partners** - Established names and brands that developers trust power the Astar zkEVM. See the [integrations section](/docs/build/zkEVM/integrations/) for more information about 3rd party service providers.
- **Interoperability and Exposure** - With Astar zkEVM, we are supporting interoperability between the Ethereum and Polkadot ecosystems, uniting communities, and empowering web3 accessibility through a common Multichain vision.
diff --git a/docs/build/zkEVM/integrations/account-abstraction/particle-network.md b/docs/build/zkEVM/integrations/account-abstraction/particle-network.md
deleted file mode 100644
index 65b7217720f..00000000000
--- a/docs/build/zkEVM/integrations/account-abstraction/particle-network.md
+++ /dev/null
@@ -1,188 +0,0 @@
----
-sidebar_position: 4
----
-
-import Figure from '/src/components/figure'
-
-# Particle Network Smart Wallet-as-a-Service
-
-Particle Network's Wallet Abstraction services enable universal, Web2-adjacent onboarding and interactions. Its core technology, [Smart Wallet-as-a-Service](https://blog.particle.network/announcing-our-smart-wallet-as-a-service-modular-stack-upgrading-waas-with-erc-4337) (WaaS) aims to onboard users into MPC-secured smart accounts supporting any chain. It also allows developers to offer an improved user experience through modular, fully customizable EOA/AA embedded wallets. Particle supports its Smart Wallet-as-a-Service through a Modular L1 powering chain abstraction, acting as a settlement layer across chains for a seamless multi-chain experience.
-
-Particle supports Astar zkEVM Testnet through both EOA interactions and native ERC-4337 SimpleAccount implementations.
-
-Using Particle Network Wallet-as-a-Service for a secure, flexible embedded wallet implementation on Astar is quite simple.
-
-## Create an application
-
-To use Particle Network's Smart Wallet-as-a-Service on Astar, you'll need to begin by creating an account on the [Particle Network dashboard](https://dashboard.particle.network) and spinning up an application.
-
-1. Navigate to the Particle Network dashboard, then sign up or log in
-
-
-2. Once logged in, create a new project
-
-
-2. Once logged in, create a new project.
-
-
-
-3. Enter the new project and create a new application
-
-
-
-4. Finally, copy the project ID, client key, and app ID
-
-
-
-## Install dependencies
-
-To integrate Particle Network within your Astar application, you'll need to install a number of dependencies- the specifics of which depend on whether you intend on purely using the default EOA generated by Particle's Wallet-as-a-Service, or if you intend to leverage an attached smart account.
-
-For both EOA & smart account utilization, install `@particle-network/auth`
-
-```bash
-npm install @particle-network/auth
-
-// OR
-
-yarn add @particle-network/auth
-```
-
-If you'd like to natively use ERC-4337 account abstraction, also install `@particle-network/aa`
-
-```bash
-npm install @particle-network/aa
-
-// OR
-
-yarn add @particle-network/aa
-```
-
-## Configure Particle Network
-
-With an application made and dependencies installed, you can move on to configuring `ParticleNetwork` from `@particle-network/auth`, and if applicable, `SmartAccount` from `@particle-network/aa`.
-
-```js
-import { ParticleNetwork } from '@particle-network/auth';
-import { AstarzkEVMTestnet } from '@particle-network/chains';
-import { SmartAccount } from '@particle-network/aa';
-
-// Project ID, client key, and app ID from https://dashboard.particle.network
-const config = {
- projectId: process.env.REACT_APP_PROJECT_ID,
- clientKey: process.env.REACT_APP_CLIENT_KEY,
- appId: process.env.REACT_APP_APP_ID,
-};
-
-const particle = new ParticleNetwork({
- ...config,
- chainName: AstarzkEVMTestnet.name,
- chainId: AstarzkEVMTestnet.id,
- wallet: { displayWalletEntry: true }
-});
-
-// If using AA
-const smartAccount = new SmartAccount(new ParticleProvider(particle.auth), {
- ...config,
- aaOptions: {
- simple: [{ chainId: AstarzkEVMTestnet.id, version: '1.0.0' }]
- }
-});
-```
-At this point, you've signed up to the Particle dashboard and created an application, installed all required dependencies, and configured `ParticleNetwork`, along with `SmartAccount` if applicable.
-
-## Example of utilization
-
-With the aforementioned established, Particle Network can be used similarly to as is shown in the example application below.
-
-Specifically, this application creates a smart account (of type "SimpleAccount") on Astar zkEVM Testnet through social login, then uses it to send a test transaction of 0.001 ASTR.
-
-```js
-import React, { useState, useEffect } from 'react';
-import { ParticleNetwork } from '@particle-network/auth';
-import { ParticleProvider } from '@particle-network/provider';
-import { AstarzkEVMTestnet } from '@particle-network/chains';
-import { AAWrapProvider, SmartAccount } from '@particle-network/aa';
-import { ethers } from 'ethers';
-
-const config = {
- projectId: process.env.REACT_APP_PROJECT_ID,
- clientKey: process.env.REACT_APP_CLIENT_KEY,
- appId: process.env.REACT_APP_APP_ID,
-};
-
-const particle = new ParticleNetwork({
- ...config,
- chainName: AstarzkEVMTestnet.name,
- chainId: AstarzkEVMTestnet.id,
- wallet: { displayWalletEntry: true }
-});
-
-const smartAccount = new SmartAccount(new ParticleProvider(particle.auth), {
- ...config,
- aaOptions: {
- simple: [{ chainId: AstarzkEVMTestnet.id, version: '1.0.0' }]
- }
-});
-
-const customProvider = new ethers.providers.Web3Provider(new AAWrapProvider(smartAccount), "any");
-
-particle.setERC4337({
- name: 'SIMPLE',
- version: '1.0.0'
-});
-
-const App = () => {
- const [userInfo, setUserInfo] = useState(null);
- const [balance, setBalance] = useState(null);
-
- useEffect(() => {
- if (userInfo) {
- fetchBalance();
- }
- }, [userInfo]);
-
- const fetchBalance = async () => {
- const address = await smartAccount.getAddress();
- const balance = await customProvider.getBalance(address);
- setBalance(ethers.utils.formatEther(balance));
- };
-
- const handleLogin = async (preferredAuthType) => {
- const user = !particle.auth.isLogin() ? await particle.auth.login({preferredAuthType}) : particle.auth.getUserInfo();
- setUserInfo(user);
- }
-
- const executeUserOp = async () => {
- const signer = customProvider.getSigner();
- const tx = {
- to: "0x000000000000000000000000000000000000dEaD",
- value: ethers.utils.parseEther("0.001"),
- };
- const txResponse = await signer.sendTransaction(tx);
- const txReceipt = await txResponse.wait();
- console.log('Transaction hash:', txReceipt.transactionHash);
- };
-
- return (
-
- {!userInfo ? (
-
-
-
-
- ) : (
-
-
{userInfo.name}
-
- {balance} ASTR
-
-
-
- )}
-
- );
-};
-
-export default App;
-```
diff --git a/docs/build/zkEVM/integrations/account-abstraction/relayers/_category_.json b/docs/build/zkEVM/integrations/account-abstraction/relayers/_category_.json
deleted file mode 100644
index b3d5a52210e..00000000000
--- a/docs/build/zkEVM/integrations/account-abstraction/relayers/_category_.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
- "label": "Relayers",
- "position": 3
-}
diff --git a/docs/build/zkEVM/integrations/account-abstraction/relayers/gelato-relay.md b/docs/build/zkEVM/integrations/account-abstraction/relayers/gelato-relay.md
deleted file mode 100644
index 6f80a7d261b..00000000000
--- a/docs/build/zkEVM/integrations/account-abstraction/relayers/gelato-relay.md
+++ /dev/null
@@ -1,149 +0,0 @@
----
-sidebar_position: 1
-description: "Using Gelato Relay, we relay your user's transactions on-chain, enabling secure gasless transactions for an ultra-smooth UX for your app"
----
-
-# Gelato Relay
-
-## Introduction
-
-Using Gelato Relay, we relay your user's transactions on-chain, enabling secure gasless transactions for an ultra-smooth UX for your app. This allows for a variety of new web3 experiences, as the user can now pay by only signing a message, or their transaction costs can be sponsored by the developer. As long as the gas costs are covered in one of the multiple payment methods that Gelato supports, we handle the rest reliably, quickly and securely.
-
-## Prerequisites
-
- - "node": ">=14.0.0"
- - Basic JavaScript knowledge.
- - ethers knowledge
-
-## Getting started
-
-### 1: Installation
-Install the Gelato Relay SDK
-
-```shell
-yarn add @gelatonetwork/relay-sdk
-```
-### 2: Choose the Method
-
-At this point, you will need to answer the following questions, which will determine the method to use when calling the Gelato Relay.
-
-- **Do you require user authentication?**
- When the use-case requires to authenticate the original user, you will need to implement the ERC2771 method where the user will sign the payload, and the original user will be decoded on-chain from the callData replacing `msg.sender` through `_msgSender()`, please see additional info [here](https://docs.gelato.network/developer-services/relay/erc-2771-recommended).
-
-- **What is the funding strategy?**
- When relaying a transaction, the Gelato Nodes are paying the gas fees. There are two different ways of paying the fees back to Gelato. Either creating a [1Balance](https://docs.gelato.network/developer-services/1balance) account and deposit USDC on polygon that will pay for all of the transactions on all EVM chains Gelato is deployed; or transferring back to gelato the fees while the transaction is executing, we call these methods `syncFee`, more info can be found [here](https://docs.gelato.network/developer-services/relay/payment-and-fees#syncfee), in this latter case, the target contract would need to inherit the ["Gelato Relay Context"](https://docs.gelato.network/developer-services/relay/non-erc-2771/callwithsyncfee/relay-context-contracts) contracts, so the methods to query and transfer the fee to Gelato are available.
-
-
-1) If you require user authentication and you want to pay the transactions with a 1Balance account, the method to use is the [sponsoredCallERC2771](https://docs.gelato.network/developer-services/relay/erc-2771-recommended/sponsoredcallerc2771l).
-
-2) If you require user authentication and you want every transaction to pay for itself, transferring by execution the fees to Gelato, the method to use is the [callWithSyncFeeERC2771](https://docs.gelato.network/developer-services/relay/erc-2771-recommended/callwithsyncfeeerc2771).
-
-3) If you don't require user authentication and you want to pay the transactions with a 1Balance account, the method to use is the [sponsoredCall](https://docs.gelato.network/developer-services/relay/non-erc-2771/sponsoredcall).
-
-4) If you don't require user authentication and you want every transaction to pay for itself, transferring the fees by execution to Gelato, the method to use is the [callWithSyncFee](https://docs.gelato.network/developer-services/relay/non-erc-2771/callwithsyncfee).
-
-
-
-### 3: Implementation
-
-We will require three simple steps to implement Gelato Relay.
-Here, we are going to showcase the three steps required to implement the method [sponsoredCallERC2771](https://docs.gelato.network/developer-services/relay/erc-2771-recommended/sponsoredcallerc2771l), which is the most used one.
-
-- Step 1: Inherit Context Contract
-Depending on the method, you must inherit different contracts as they will provide other methods. In this case, we will have to inherit the [ERC2771Context](https://github.com/gelatodigital/relay-context-contracts/blob/master/contracts/vendor/ERC2771Context.sol). The ERC2771Context provide us with the methods `_msgSender()` and `_msgData()` that will allow us to recover the original user sending the transaction.
-
-```sol
- import {
- ERC2771Context
- } from "@gelatonetwork/relay-context/contracts/vendor/ERC2771Context.sol";
-
- contract CounterERC2771 is ERC2771Context {
-
- // ERC2771Context: setting the immutable trustedForwarder variable
- constructor(address trustedForwarder) ERC2771Context(trustedForwarder) {}
-
- function incrementContext() external {
-
- // Incrementing the counter mapped to the _msgSender!
- contextCounter[_msgSender()]++;
-
- // Emitting an event for testing purposes
- emit IncrementContextCounter(_msgSender());
- }
- }
-```
-
-- Step 2: Import the relay SDK
-In your frontend/backend, you would need to import and instantiate the relay class.
-
-```js
- import { GelatoRelay, SponsoredCallERC2771Request } from "@gelatonetwork/relay-sdk";
- const relay = new GelatoRelay(API_KEY);
-```
-
-- Step 3: Send the payload to Gelato
-This is an example using Gelato's CounterERC2771.sol, which is deployed on these networks.
-
-```js
- // Set up on-chain variables, such as target address
- const counter = "0x00172f67db60E5fA346e599cdE675f0ca213b47b";
- const abi = ["function incrementContext()"];
- const provider = new ethers.BrowserProvider(window.ethereum);
- const signer = provider.getSigner();
- const user = signer.getAddress();
-
- // Generate the target payload
- const contract = new ethers.Contract(counter, abi, signer);
- const { data } = await contract.incrementContext.populateTransaction();
-
- // Populate a relay request
- const request: CallWithERC2771Request = {
- chainId: (await provider.getNetwork()).chainId,
- target: counter;
- data: data;
- user: user;
- };
-
- // Without a specific API key, the relay request will fail!
- // Go to https://relay.gelato.network to get a testnet API key with 1Balance.
- // Send a relay request using Gelato Relay!
- const relayResponse = await relay.sponsoredCallERC2771(request, provider, apiKey);
-```
-
-### 4: Tracking your request
-
-When submitting your Gelato Relay requests, you'll receive a taskId in response. This taskId allows you to track the status of your request in two primary ways:
-
-1) WebSocket Subscriptions: This is the recommended and most efficient method. By subscribing via WebSocket, the Gelato backend will automatically push updates for all your tasks to your Relay SDK client. To start receiving these updates, you must register a callback function, which will be triggered every time one of your tasks gets updated. Detailed implementation can be found [here](https://docs.gelato.network/developer-services/relay/tracking-your-relay-request#websocket-subscriptions).
-
-2) Polling for Updates: Alternatively, you can periodically query the Gelato task status API for updates. If you're using the Gelato Relay SDK, the getTaskStatus method makes this easy. Detailed implementation can be found [here](https://docs.gelato.network/developer-services/relay/tracking-your-relay-request#polling-for-updates).
-
-### 5: Templates
-
-- [Example repo](https://github.com/gelatodigital/relay-examples-frontend-backend-v5) showcasing all Relay SDK methods with node and react implementations
-- Relay Hardhat [unit tests](https://github.com/gelatodigital/relay-example-unit-tests)
-- Relay [sponsored nft mint](https://github.com/gelatodigital/relay-sponsored-nft-mint)
-
-## Rate Limits, Fees & Contract Addresses
-
-### Rates
-:::info
-Pro Tier: For access to pro tier and custom rate limits, please request an upgrade [here](https://www.gelato.network/contact)
-:::
-
-| Standard Rate Limits | Pro Rate limits |
-| --- | ----------- |
-| 5 req/min | 30 req/min |
-
-### Gelato's Fees
-
-Gelato charges a fixed 10% percentage fee of the relayed transactions' total gas cost.
-
-### Contract Addresses
-Please visit [Gelato Contract Addresses](https://docs.gelato.network/developer-services/relay/networks-and-rate-limits#contract-addresses).
-
-
-## Learn more
-
-- [Gelato Website](https://www.gelato.network/)
-- [Gelato Docs](https://docs.gelato.network/introduction/what-is-gelato)
diff --git a/docs/build/zkEVM/integrations/account-abstraction/relayers/index.md b/docs/build/zkEVM/integrations/account-abstraction/relayers/index.md
deleted file mode 100644
index 2006ea1858a..00000000000
--- a/docs/build/zkEVM/integrations/account-abstraction/relayers/index.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# Relayers
-
-Account Abstraction (EIP-4337) provides a mechanism for native Meta Transactions to be a part of the Ethereum protocol.
-
-## Meta Transactions
-
-Meta transactions allow users to perform Ethereum transactions without having ETH for gas fees. Instead, they sign a transaction with their private key and then pass it to a third party, known as a Relayer, that broadcasts the transaction to the Ethereum network. The Relayer pays the gas fee and, in turn, can be compensated by the user in another token or even off-chain.
-
-### How Relayers work
-
-**User-Signed Payloads:** Users create and sign transaction payloads but don't broadcast them to the network directly.
-
-**Relayer Role:** Instead of broadcasting transactions, users send their signed payloads to a Relayer. The Relayer then wraps these payloads in standard Ethereum transactions and broadcasts them to the network.
-
-**Gas Payment:** The gas for transactions is paid by the Relayer. However, it is also possible for the Relayer to be reimbursed by users in a token other than ETH.
-
-**Sponsorship:** Sponsors cover transaction fees. In this context, the sponsor could be considered a specific type of Relayer that willingly pays transaction fees on behalf of users without expecting reimbursement.
-
-
-
-
-
-import DocCardList from '@theme/DocCardList';
-import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
-
-
-
diff --git a/docs/build/zkEVM/integrations/account-abstraction/safe--aa/_category_.json b/docs/build/zkEVM/integrations/account-abstraction/safe--aa/_category_.json
deleted file mode 100644
index c4ed248328d..00000000000
--- a/docs/build/zkEVM/integrations/account-abstraction/safe--aa/_category_.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
- "label": "Safe AA SDK with Gelato",
- "position": 2
-}
diff --git a/docs/build/zkEVM/integrations/account-abstraction/safe--aa/index.md b/docs/build/zkEVM/integrations/account-abstraction/safe--aa/index.md
deleted file mode 100644
index 968febb0dae..00000000000
--- a/docs/build/zkEVM/integrations/account-abstraction/safe--aa/index.md
+++ /dev/null
@@ -1,186 +0,0 @@
-# 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 | zkatana-gelato-protocol-kit|
-| Safe AA Kit | zkatana-gelato-account-abstraction-kit|
-| Safe Relay Kit | zkatana-gelato-relay-kit|
-
-
-There are two different ways to send Gasless Transactions through a Safe, either sponsoring the gas with [1Balance](https://docs.gelato.network/developer-services/1balance) or paying with the Safe balance (SyncFee)
-
-In following examples examples, it will be called the `increment()` method on this simple counter contract deployed on zKatana [https://zkatana.blockscout.com/address/0x47A9064a8D242860ABb43FC8340B3680487CC088?tab=read_contract](https://zkatana.blockscout.com/address/0x47A9064a8D242860ABb43FC8340B3680487CC088?tab=read_contract)
-
-## Quick Start
-
-1) Clone the [starter-kit](https://github.com/gelatodigital/astar-zkatana-starter-kit) repo
-
-2) Install project dependencies:
-```
-yarn install
-```
-in the package.json we have already included zkatana-gelato-protocol-kit, zkatana-gelato-account-abstraction-kit and zkatana-gelato-relay-kit
-```shell
- "zkatana-gelato-account-abstraction-kit": "^1.3.2",
- "zkatana-gelato-protocol-kit": "^1.3.1",
- "zkatana-gelato-relay-kit": "^1.3.2"
-```
-
-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://relay.gelato.network
-
-4) Call the respective method:
- - Using 1Balance
- ```tyescript
- yarn aa1Balance
- ```
- - Using SyncFee
- ```tyescript
- yarn aaSyncFee
- ```
-
-
-
-### 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
-```
-
-### Using SyncFee
-Remember to fund your Safe as the gas fees will be deducted from your safe balance
-
-```typescript
-
- const gasLimit = "10000000";
-
-
- 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,
- GAS_TOKEN: ethers.constants.AddressZero,
- };
-
- 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,
- gasToken: txConfig.GAS_TOKEN,
- isSponsored: false,
- };
-
- const response = await safeAccountAbstraction.relayTransaction(
- safeTransactions,
- options
- );
- console.log(`https://relay.gelato.digital/tasks/status/${response} `);
-```
-
- **Output**
- ```shell
- $ ts-node src/aa-safe-gasless/aaSyncFee.ts
-{ predictedSafeAddress: '0x68D60c586763879c6614e2eFA709cCae708203c4' }
-{ isSafeDeployed: true }
-https://relay.gelato.digital/tasks/status/0x6590f89386d9adb8a6d20ba7dffaa17958d4e66d49e6a0d3b5b1c144022abbc1
- ```
diff --git a/docs/build/zkEVM/integrations/account-abstraction/web3auth/web3auth-zkatana.md b/docs/build/zkEVM/integrations/account-abstraction/web3auth/web3auth-zkatana.md
index 62b3b8a7b90..9e81bec1551 100644
--- a/docs/build/zkEVM/integrations/account-abstraction/web3auth/web3auth-zkatana.md
+++ b/docs/build/zkEVM/integrations/account-abstraction/web3auth/web3auth-zkatana.md
@@ -1,5 +1,5 @@
---
-title: Using Web3Auth on Astar zKatana
+title: Using Web3Auth
sidebar_position: 1
---
diff --git a/docs/build/zkEVM/integrations/automation-off-chain/_category_.json b/docs/build/zkEVM/integrations/automation-off-chain/_category_.json
deleted file mode 100644
index 20a203bb263..00000000000
--- a/docs/build/zkEVM/integrations/automation-off-chain/_category_.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
- "label": "Automation & Off-Chain Data",
- "position": 2
-}
diff --git a/docs/build/zkEVM/integrations/automation-off-chain/img/functions.png b/docs/build/zkEVM/integrations/automation-off-chain/img/functions.png
deleted file mode 100644
index b4ffa5a7a16b05b2ba5b9bec2f5553a6d745a778..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 190275
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
z
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