{
  "elder_grpc": "localhost:9090",
  "endpoints": {
    "rollapp1": {
      "endpoint": "/rollapp1",
      "rpc": "http://localhost:8545",
      "elder_registration_id": 1
    }
  }
}
Elder-Wrap is a powerful adapter that lets you interact with EVM RollApps on the Elder Chain using familiar EVM tools. It bridges your local development environment with the Elder ecosystem, making it easy to deploy contracts, send transactions, and manage keys across multiple RollApps. This guide covers everything you need to get started with Elder-Wrap, including setup, usage, keystore management, API endpoints, Docker deployment, and workflow best practices. Whether you’re a developer familiar with Hardhat, Truffle, or Remix, or you’re new to the Elder ecosystem, this page will help you integrate quickly and securely.
Elder-Wrap provides a familiar interface for developers already using EVM tools, making it easy to deploy contracts, send transactions, and manage keys across RollApps.
GitHub access for Elder is currently limited to early partner projects and may not be available to everyone. The documentation may be outdated due to rapid development.

What is Elder-Wrap?

Elder-Wrap acts as a bridge between your local development environment and RollApps on the Elder Chain. By starting the elder-wrap binary, developers can:
  • Deploy Contracts: Treat elder-wrap as a local EVM node to deploy smart contracts on any RollApp
  • Send and Query Transactions: Use it to send transactions and query their status easily
  • Integrate with EVM Tooling: Connect elder-wrap to popular EVM-compatible tools like Hardhat, Truffle, or Remix
  • Manage Keys: Use the built-in keystore functionality to manage your keys securely

Key Features

  • Acts as a bridge between your local environment and RollApps on the Elder Chain
  • Provides a familiar interface for developers already using EVM tools
  • Simplifies contract deployment and transaction management across RollApps
  • Built-in keystore functionality for secure key management

Usage Overview

To use Elder-Wrap, you will:
  1. Build and start the server
  2. Configure your EVM tooling to point to the Elder-Wrap endpoint
  3. Use your preferred EVM tools as you would with any local node
  4. Manage keys using the built-in keystore

Getting Started

Follow these steps to get Elder-Wrap running in your environment (detailed commands and examples will be added after confirming this renders correctly).
cp config.yaml.sample config.yaml
# Fill appropriate values in config.yaml
go build -o elder-wrap
./elder-wrap server
1

Clone and Build

Clone the repository, copy the sample config, and build the binary.
2

Start the Server

Run the Elder-Wrap server locally.
3

Configure EVM Tooling

Point your EVM tools (like Hardhat or Truffle) to the Elder-Wrap endpoint (e.g., http://localhost:8546/rollApp_alias).
4

Use Your Preferred Tools

Deploy contracts and send transactions as you would with any local EVM node.
./elder-wrap keystore list

Keystore Management

Elder-Wrap includes a built-in keystore for managing your keys securely. You can:
  • List all keys
  • Import a new key
  • Delete a key
  • Query key details by alias, elder address, or EVM address
./elder-wrap keystore list

API Endpoints

Elder-Wrap exposes endpoints for listing RollApp configurations and sending transactions. You can also interact with it programmatically from your dApps. To list all RollApp configurations, use:
curl http://localhost:8546/

Example API Response

Here’s what a successful response looks like:
{
  "elder_grpc": "localhost:9090",
  "endpoints": {
    "rollapp1": {
      "endpoint": "/rollapp1",
      "rpc": "http://localhost:8545",
      "elder_registration_id": 1
    }
  }
}

Docker Build Options

Elder-Wrap can be built and run using Docker for easier deployment and environment management.
docker buildx bake --load
docker buildx bake --load --set *.args.GITHUB_ACCESS_TOKEN=<your_token>

Usage Workflow

1

Configure Your Environment

Set up your config.yaml file with appropriate values for your RollApp configuration.
2

Start Elder-Wrap Server

Run ./elder-wrap server to start the adapter service.
3

Connect Your Development Tools

Point your Hardhat, Truffle, or other EVM tools to the Elder-Wrap endpoint.
4

Deploy and Interact

Deploy contracts and send transactions as you would with any local EVM node.
5

Manage Keys (Optional)

Use the keystore functionality to manage your private keys securely.
For advanced configuration, troubleshooting, and updates, see the official Elder-Wrap docs.