Contract Addresses

Token Details

VOW is a token on the Ethereum Network.

Its contract address is: 0x1BBf25e71EC48B84d773809B4bA55B6F4bE946Fb

You can view full data on Etherscan — Vow (VOW).

The project has upgraded all its contracts for all vCurrencies and governance in order to operate with the new Voucher Ledger®. The sections below describe how the new contracts operate.

Overview

• The VSC Governor contract replaces all existing VSC tokens and their Token Managers, streamlining VSC management within the VOW ecosystem.
• Region IDs have been introduced to make referencing the new VSC tokens easier.
• Multi-step procedures that previously required manual repetition across regions have been replaced with single actions that can be executed simultaneously across multiple regions.
• The Provable oracle system has been replaced with Chainlink price feeds where available, providing connected regions with free, real-time exchange rate data.
• For regions without Chainlink integration, a new, optimized method for batch updating rates is provided.
• New VSC regions can now be deployed and incorporated via a single command, significantly reducing deployment costs and complexity.
• The VSC Governor contract is fully upgradeable, enhancing security and enabling future improvements and additional features.
• The underlying VSC token implementation is also fully upgradeable, with changes being applied simultaneously across all regions.

VSC Governor Owner Functions

• addRegion — Creates a new VSC region, deploying and integrating its token contract into the ecosystem.
• liquidateMerchant — Callable only by the MVD for a region when a merchant is deemed to have defaulted. Takes control of any VOW tokens locked against the merchant and uses them to acquire as many of the region's VSC tokens as possible via Uniswap, then burns them all.
• setMVD — Sets the MVD for the specified region ID, locking whatever VOW deposit is required from them in the contract.
• removeMVD — Removes the MVD for the specified region ID, returning their original VOW deposit, minus any forfeiture levied by the community (default is zero).
• transferOwnership — Two-phase ownership change: the current owner calls transferOwnership, then the new owner completes the process with acceptOwnership.
• updateConfig — Selectively updates the address allowed to set internal rates, the max permitted freshness of internal rates, the value that determines when the VOW to USD rate should be refreshed, and the maximum permitted difference between the last observed rate and the rate calculated at transaction time.
• updateDeposit — Updates the VOW deposit required to become an MVD for the specified region ID(s).
• updateFeed — Updates the address of the fiat price feed for the specified region ID.
• updateOwner — Updates the owner address for the specified region ID(s).
• updatePauseTransfers — Pauses or unpauses token transfers and burns for the specified region ID(s).
• updateTransferBurn — Updates the proportion of VSC burned on transfers between non-whitelisted accounts for the specified region ID(s).
• updateTransferBurnWhitelist — Adds or removes an account from the transfer burn whitelist for the specified region ID(s).
• updateVSCMintOnLock — Updates the multiplier determining the amount of VSC to be minted upon a merchant lock for the specified region ID(s).
• updateVOWToVSCWhitelist — Adds or removes an account from the VOW to VSC conversion whitelist for the specified region ID(s).

Note: For convenience, passing an empty array applies an update to all regions.

Read Methods

• previewLiquidateMerchant — Previews the expected result of a merchant liquidation.
• regions — Returns Region ID, token name, token symbol, and token contract address for all VSC regions.
• vscPerVOW — Returns the current number of VSC tokens equivalent to one VOW for the specified region ID.

Exchange Rates

VOW to VSC exchange rates are calculated whenever a VOW to VSC exchange (burn & mint), a merchant lock transaction, or a call to vscPerVOW occurs. The rates depend on VOW's current USDT value, along with the current fiat USD rate for the region. The VOW USDT price is retrieved directly from its Uniswap V2 pair. The source of the fiat rate depends on the region:

• Regions with Chainlink integration use their Chainlink price feed for the current rate.
• Regions without Chainlink use the latest rate stored in the VSC Governor, which must be periodically updated by the owner.

A helper task is provided to retrieve live rates for all non-Chainlink regions and batch-update the VSC Governor with any new rates.

VOW to VSC and Merchant Locking / Unlocking

The VSC Governor serves as the central point for users, MVDs, and merchants to send tokens to either exchange VOW for VSC or lock/unlock merchant accounts.

Exchanging VOW for VSC. Any whitelisted account can exchange VOW for VSC by sending VOW tokens to the Governor. The Governor will burn the VOW tokens and mint an equivalent amount of VSC tokens. The exact amount depends on the region's USD fiat exchange rate and the Uniswap VOW/USDT price at the time of the transaction.

Locking. MVDs can lock VOW against their merchants to generate new VSC for circulation on tier 2. The MVD sends VOW to the Governor, specifying the required VSC token and the merchant's address in the data payload. The VSC Governor then mints a multiplied amount of the specified VSC at the current market rate, triggers a lift of the minted VSC to the MVD's illiquid wallet on tier 2 via the connected VOW bridge, and registers the locked VOW against the merchant along with the amount of VSC required to unlock it.

Unlocking. Any account can unlock a VOW position by sending the correct amount of VSC to the Governor, specifying the merchant in the data payload. The VSC will be burned, and the locked VOW will be released to the associated merchant.

Testing

• All tests are executed against the current state of the Ethereum mainnet, using the real-world Uniswap, Chainlink, VOW Bridge, VOW, and USDT token contracts.
• During testing, live market data is collected from Mixin and CoinGecko APIs to verify the VSC Governor's calculations against live fiat and crypto exchange rates.
• Contract gas consumption is reported at the end.

Ethereum Smart Contract Deployment — 24th September 2024

Latest deployment details of the Ethereum smart contracts as of 24th September 2024.

VOW & v-Currencies

Core ecosystem tokens — the VOW protocol token and the v-currency family (v$, v£, v€, vUSD) deployed natively or bridged across Ethereum and BNB Chain.

Liquidity Pool Tokens

Official LP tokens issued by Uniswap (Ethereum) and PancakeSwap (BNB Chain) for the pools that anchor VOW and v-currency liquidity.

Discontinued v-Currencies

These earlier v-currency contracts and order-book deployments on Ethereum have been deprecated and are no longer in active use. Addresses are preserved here for reference and audit continuity.