> For the complete documentation index, see [llms.txt](https://champlify-labs-llc.gitbook.io/ssow/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://champlify-labs-llc.gitbook.io/ssow/whale-shadows/how-to-obtain/block-explorer/beacon-contract.md).

# Beacon Contract

You can sync your Whale Shadows by directly interacting with the Beacon contract on each supported chain using the `read()` function.

> **Contract Addresses**: For the specific Beacon contract addresses on each chain, see [Via Block Explorer](/ssow/whale-shadows/how-to-obtain/block-explorer.md).

## Overview

The `read()` function on the Beacon contract triggers an ownership update for specific token IDs by querying the LayerZero network to verify the current owner on Ethereum. This is the most direct way to sync your Shadows.

## Step-by-Step Instructions

### Step 1: Open the Beacon contract on the appropriate block explorer

1. Go to the **Beacon contract** on your target chain (see [contract addresses](/ssow/whale-shadows/how-to-obtain/block-explorer.md))
2. Open the contract in the appropriate **block explorer** (see [block explorer links](/ssow/whale-shadows/how-to-obtain/block-explorer.md))
   * search for the Beacon contract address in the search bar
   * Select the **"Contract"** tab

### Step 2: Get a LayerZero Fee Quote (Optional but Recommended)

Before calling the `read()` function, you should get a quote for the LayerZero fees:

1. Navigate to the **"Read"** tab
2. Use the `quoteRead` function with these parameters:
   * **baseCollectionAddress**: `0x88091012eedf8dba59d08e27ed7b22008f5d6fe5` (SSoW contract)
   * **tokenIds**: Array of your whale token IDs (e.g., `[1234,5678]`) (separate the token IDs with commas, no spaces between the IDs)
   * **eids**: Array with Ethereum's EID `[30101]`
   * **supplementalGasLimit**: `0` (unless you know you need more)
3. The output will be a quote **in wei**. You'll need to convert this to **native currency** (denoted as ether in the contracts, but may vary by chain) for the next step.

**Converting Wei to Native Currency:**

* The quote output is in wei (e.g., `396743845460449060`)
* To convert to the native currency: divide by 10^18 (i.e. move the decimal point 18 places to the left) or use an online converter
* Examples:
  * `396743845460449060` wei = `0.396743845460449060` in $APE
  * `95782692294585` wei = `0.000095782692294585` in $ETH
* **ApeChain**: Native currency is ApeCoin (APE)
* **Abstract**: Native currency is Ether (ETH)
* Most block explorers show both values when you click the result

### Step 3: Call the Read Function

1. Navigate to the **"Write"** tab
2. Connect your wallet (`Connect to Web3`)
3. Use the `read` function with these parameters:
   * **baseCollectionAddress**: `0x88091012eedf8dba59d08e27ed7b22008f5d6fe5` (SSoW contract address)
   * **tokenIds**: Array of your whale token IDs (e.g., `[1234, 5678]`)
   * **eids**: Array with Ethereum's EID `[30101]`
   * **refundRecipient**: Your wallet address (where excess fees will be refunded)
   * **supplementalGasLimit**: `0` (unless you know you need more gas)
   * **payableAmount**: The quote from Step 2 **converted to native currency units** (e.g., `0.311741542926477626`)
     * If you skipped the optional Step 2, you can put in around $1-2 USD worth of the chain's native currency. You will be refunded any extra you send.
4. Click **"Write"** and confirm the transaction in your wallet

> **Important**: The `payableAmount` field expects the value in **native currency units** (APE on ApeChain, ETH on Abstract), not wei. Make sure to convert the quote from Step 1 before entering it.

### Step 4: Track Progress

1. Copy your transaction hash
2. Go to [LayerZero Scan](https://layerzeroscan.com)
3. Paste your transaction hash to track the cross-chain verification progress
4. The process typically takes about 1 minute to complete
5. Check shadow token transfers using the tokens page in the respective block explorer
   * https\://\<block explorer>/token/\<shadow token address> (e.g., `https://apescan.io/token/0x3C3E92B627a817832DEd520Da5640246c9AAAF65`)

## Important Notes

* **Overpaying is Safe**: If you overpay the LayerZero fee, you'll automatically be refunded the difference
* **Estimation**: You can estimate the fee (\~25-30 cents USD) instead of getting an exact quote from Step 2
* **Multiple Tokens**: You can update multiple token IDs in a single transaction.
* **Chain-Specific**: You need to call this function on each chain where you want to sync your Shadows

## Troubleshooting

If your Shadow doesn't update as expected:

1. Verify your token ownership on Ethereum
2. Check if you have any active delegations using the ExclusiveDelegateResolver
3. Ensure you're using the correct LayerZero EID (30101 for Ethereum)
4. Wait a few minutes and check LayerZero Scan for completion status