kazuya1966/ars

Alternative frontend for Ambient Finance with gasless transactions

Ambient Relay Service

This is an alternative frontend for Ambient Finance that has a gasless transaction relayer. It allows users to execute Ambient DEX commands without needing gas on their address if they have enough tokens on their DEX balance to cover the gas.

The project is deployed at https://ars.bus.bz and works with Ambient/CrocSwap contracts on Ethereum, Scroll, Canto, Goerli, Arbitrum Goerli, and Scroll Sepolia.

Features

• Supports balance withdrawal/transfer, LP removal, swaps, deposits (EIP-2612)
• Different ways of command execution:
  • Fully relayed mode – if you don't have any ETH on any address, but have enough DEX balance to pay a tip to the relayer
  • Manually relayed mode – if you have a ETH on a different address, but don't want to (or can't) send it to the address in question
  • Manual mode – regular transactions like the official frontend would send
• Tips are based on gas estimates of the transaction and can be paid with any token that the relayer permits
• Tip estimation happens locally, the relayer only sees the signed transaction when the users asks to relay it

Screenshot

Building and running

1. Deposit ETH to a relayer address and specify its private key in the PK environment variable
2. Set the domain of your relayer endpoint in the RELAYERS variable in frontend/src/App.vue
3. (Optional) Set your self-hosted indexer URL before the official URL in frontend/src/graphcache_provider.js
4. Build and run relayer: npm install && node run index.mjs
5. Build and deploy frontend: npm install && npm run build

TODO

• Limit orders, collapsible exchange panel
• LP management/creation
• Self hosted indexer and graph node

Attributions

• Vue – MIT License, Copyright (c) 2013-present, Yuxi (Evan) You
• Bootstrap – MIT License, Copyright (c) 2011-2023 The Bootstrap Authors
• Bootstrap-vue – MIT License, Copyright (c) 2016-2023 - BootstrapVue
• Bootstrap-dark – MIT License, Copyright (c) 2018-2021 Carl-Hugo Marcottee
• ethers.js – MIT License, Copyright (c) 2016-2023 Richard Moore
• eth-permit – MIT License, Copyright (c) 2020-2023 David Mihal
• CrocSwap SDK – MIT License, Copyright (c) 2022 Crocodile Labs, Inc.
• web3modal – Apache License 2.0, Copyright 2021 WalletConnect, Inc.
• viem+wagmi – MIT License, Copyright (c) 2022-present weth, LLC
• Express+Morgan – MIT License, Copyright (c) 2009-2014 TJ Holowaychuk, Copyright (c) 2013-2014 Roman Shtylman, Copyright (c) 2014-2015 Douglas Christopher Wilson
• Lifesaver SVG – CC0 1.0 Universal License, Barret Ruttan
• Outward font – SIL Open Font License 1.1, Raoul Audouin, Velvetyne Type Foundry

Copyright and license

This project is released under the MIT License (see LICENSE file).

Copyright © 2023 bus.