mirror of https://github.com/datahaven-xyz/datahaven synced 2026-05-24 01:38:32 +00:00

feat: ✨ Native Token Transfer to Ethereum (#88 )

### Summary

- Implement native token transfers from DataHaven to Ethereum using
Snowbridge infrastructure
- Add comprehensive datahaven-native-transfer pallet with lock-and-mint
mechanism for cross-chain token representation

  ### Key Features

  **New Pallet: datahaven-native-transfer**

- Cross-chain transfers: Transfer DataHaven native tokens to Ethereum
addresses via `transfer_to_ethereum extrinsic`
- Token locking mechanism: Secure token storage in deterministic
Ethereum sovereign account during transfers
- Fee management: Required fees for all transfers to compensate relayers
and prevent spam
  - Emergency controls: Pause/unpause functionality
- Token registration: Integration with Snowbridge's token registration
for native token identification


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

- **New Features**
- Introduced the DataHaven Native Transfer pallet enabling secure
cross-chain transfers of DataHaven native tokens to and from Ethereum
via Snowbridge.
- Added token locking on DataHaven, minting on Ethereum, and mandatory
fee collection to cover gas costs and incentivize relayers.
- Implemented pause and unpause controls for emergency management of
token transfers.

- **Configuration**
- Integrated the new pallet into mainnet, stagenet, and testnet runtimes
with updated network, account, and treasury settings.
- Added Ethereum sovereign account constants and native token ID support
for optimized cross-chain operations.

- **Documentation**
- Added comprehensive README and inline documentation detailing pallet
features, extrinsics, events, errors, and security considerations.

- **Tests**
- Added extensive unit and integration tests covering token transfers,
native token registration, fee handling, pause functionality, and event
validation across all supported networks.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Steve Degosserie <723552+stiiifff@users.noreply.github.com>

2025-06-12 00:07:36 +02:00

3.3 KiB

Raw Permalink Blame History

DataHaven Native Transfer Pallet

A Substrate pallet that enables cross-chain transfers of DataHaven native tokens to and from Ethereum using the Snowbridge infrastructure.

Overview

This pallet facilitates the transfer of DataHaven (DH) native tokens to Ethereum, where they are represented as wrapped ERC20 tokens. It implements a lock-and-mint mechanism: tokens are locked on DataHaven when transferred to Ethereum, and unlocked when transferred back.

Features

Cross-chain Transfers: Transfer DH tokens to Ethereum addresses
Token Locking: Secure token locking in a sovereign account during transfers
Fee Management: Mandatory fee collection for bridge relayers
Pause Mechanism: Emergency pause functionality for security

Fee Structure

Fees are mandatory for all transfers and serve to:

Compensate relayers for Ethereum gas costs
Provide incentive for timely message delivery
Prevent spam transactions

The fee is:

Collected in DataHaven native tokens
Transferred to a designated fee recipient account
Separate from the transfer amount

Fee Calculation Guidelines

When calculating fees, consider:

Ethereum Gas Costs: Estimate gas required for the Ethereum transaction
Gas Price: Current Ethereum gas prices (use oracles or fixed estimates)
Exchange Rate: DH to ETH conversion rate
Relayer Margin: Additional incentive

Example calculation:

Ethereum gas required: 100,000 gas
Gas price: 30 gwei
ETH cost: 0.003 ETH
DH/ETH rate: 1000 DH per ETH
Base fee: 3 DH
With 20% margin: 3.6 DH

Extrinsics

`transfer_to_ethereum`

Transfer DataHaven native tokens to an Ethereum address.

Parameters:

origin: The account initiating the transfer
recipient: The Ethereum address (H160) to receive the tokens
amount: The amount of tokens to transfer
fee: The fee to cover Ethereum gas costs and incentivize relayers (must be non-zero)

`pause`

Pause all transfers. Only callable by PauseOrigin (typically governance).

`unpause`

Resume transfers after pause. Only callable by PauseOrigin.

Public Functions

`total_locked_balance`

Get the total balance of tokens locked in the Ethereum sovereign account.

`ethereum_sovereign_account`

Get the account ID of the Ethereum sovereign account for monitoring purposes.

Events

TokensLocked: Emitted when tokens are locked for transfer
TokensUnlocked: Emitted when tokens are unlocked from Ethereum
TokensTransferredToEthereum: Emitted on successful transfer to Ethereum
Paused: Emitted when the pallet is paused
Unpaused: Emitted when the pallet is unpaused

Errors

InsufficientBalance: Account has insufficient balance for transfer
Overflow: Arithmetic overflow in calculations
SendMessageFailed: Failed to send message through Snowbridge
InvalidEthereumAddress: Provided Ethereum address is zero
InvalidAmount: Transfer amount is zero
TransfersDisabled: Transfers are paused
ZeroFee: Fee cannot be zero

Security Considerations

Pause Mechanism: The pallet can be paused by governance in case of emergencies
Fee Validation: All transfers require non-zero fees to prevent spam
Balance Preservation: The pallet uses Preservation::Preserve to maintain existential deposits
Address Validation: Zero Ethereum addresses are rejected

3.3 KiB Raw Permalink Blame History