The home for Hyperlane core contracts, sdk packages, and other infrastructure
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
hyperlane-monorepo/solidity/apps
Yorke Rhodes 9cc2a4388b
Improve ergonomics of app mixins (#330)
3 years ago
..
contracts Improve ergonomics of app mixins (#330) 3 years ago
interfaces/bridge Remove abacus- prefix from directories (#267) 3 years ago
test/governance Improve ergonomics of app mixins (#330) 3 years ago
.env.example Remove abacus- prefix from directories (#267) 3 years ago
.eslintrc.json Remove abacus- prefix from directories (#267) 3 years ago
.gitignore Remove abacus- prefix from directories (#267) 3 years ago
.prettierrc Remove abacus- prefix from directories (#267) 3 years ago
.solcover.js Remove abacus- prefix from directories (#267) 3 years ago
.solhint.json Remove abacus- prefix from directories (#267) 3 years ago
.solhintignore Remove abacus- prefix from directories (#267) 3 years ago
README.md Remove abacus- prefix from directories (#267) 3 years ago
hardhat.config.ts Remove abacus- prefix from directories (#267) 3 years ago
package.json Improve ergonomics of app mixins (#330) 3 years ago
tsconfig.json Remove abacus- prefix from directories (#267) 3 years ago

README.md

Abacus Token Bridge

Message Format

Bridge messages follow the following format:

TokenID (36 bytes)
    -  4 bytes - domain specifier
    - 32 bytes - id (address) on that domain

Actions (variable)
    EITHER
    - Transfer (64 bytes)
        - 32 bytes - to. local recipient
        - 32 bytes - amount. number of tokens to send
    - Details
        - 32 bytes - name. new name of token
        - 32 bytes - symbol. new symbol for token
        -  1 byte  - decimals. new decimal place count

Message (100 or 101 bytes)
    - TokenID (36 bytes)
    - Action  (64 or 65 bytes)

Given a message we know the following:

  • the TokenID is at indices 0-35
    • 0 - 3 Domain
    • 4 - 35 Id
  • the Action is at indices 36 - end.
    • the action type can be determined from the message length alone.
    • for Transfer actions
      • 36 - 67 To
      • 68 - 99 Amount
    • for Details actions
      • 36 - 67 Name
      • 68 - 99 Symbol
      • 100 Decimals