Skip to content
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -117,6 +117,7 @@ updateauth
updaterex
updtrevision
userres
core.vaulta
vitr
vmtype
vmversion
Expand Down
2 changes: 1 addition & 1 deletion CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ else()
set(VERSION_FULL "${VERSION_MAJOR}.${VERSION_MINOR}.${VERSION_PATCH}")
endif()

message(STATUS "Building eos-system-contracts v${VERSION_FULL}")
message(STATUS "Building system-contracts v${VERSION_FULL}")

include(ExternalProject)

Expand Down
22 changes: 11 additions & 11 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
# Contributing to eos-system-contracts
# Contributing to system-contracts

Interested in contributing? That's awesome! Here are some guidelines to get started quickly and easily:

- [Reporting An Issue](#reporting-an-issue)
- [Bug Reports](#bug-reports)
- [Feature Requests](#feature-requests)
- [Change Requests](#change-requests)
- [Working on eos-system-contracts](#working-on-eos-system-contracts)
- [Working on system-contracts](#working-on-system-contracts)
- [Feature Branches](#feature-branches)
- [Submitting Pull Requests](#submitting-pull-requests)
- [Testing and Quality Assurance](#testing-and-quality-assurance)
Expand All @@ -16,7 +16,7 @@ Interested in contributing? That's awesome! Here are some guidelines to get star

## Reporting An Issue

If you're about to raise an issue because you think you've found a problem with eos-system-contracts, or you'd like to make a request for a new feature in the codebase, or any other reason… please read this first.
If you're about to raise an issue because you think you've found a problem with system-contracts, or you'd like to make a request for a new feature in the codebase, or any other reason… please read this first.

The GitHub issue tracker is the preferred channel for [bug reports](#bug-reports), [feature requests](#feature-requests), and [submitting pull requests](#submitting-pull-requests), but please respect the following restrictions:

Expand All @@ -34,12 +34,12 @@ Guidelines for bug reports:
reported.

1. **Check if the issue has been fixed** — look for [closed issues in the
current milestone](https://github.com/eosnetworkfoundation/eos-system-contracts/issues?q=is%3Aissue+is%3Aclosed) or try to reproduce it
current milestone](https://github.com/VaultaFoundation/system-contracts/issues?q=is%3Aissue+is%3Aclosed) or try to reproduce it
using the latest `main` branch.

A good bug report shouldn't leave others needing to chase you up for more information. Be sure to include the details of your environment and relevant tests that demonstrate the failure.

[Report a bug](https://github.com/eosnetworkfoundation/eos-system-contracts/issues/new?title=Bug%3A)
[Report a bug](https://github.com/VaultaFoundation/system-contracts/issues/new?title=Bug%3A)

### Feature Requests

Expand All @@ -51,24 +51,24 @@ Feature requests are welcome. Before you submit one be sure to have:

### Change Requests

Change requests cover both architectural and functional changes to how eos-system-contracts works. If you have an idea for a new or different dependency, a refactor, or an improvement to a feature, etc - please be sure to:
Change requests cover both architectural and functional changes to how system-contracts works. If you have an idea for a new or different dependency, a refactor, or an improvement to a feature, etc - please be sure to:

1. **Use the GitHub search** and check someone else didn't get there first
1. Take a moment to think about the best way to make a case for, and explain what you're thinking. Are you sure this shouldn't really be
a [bug report](#bug-reports) or a [feature request](#feature-requests)? Is it really one idea or is it many? What's the context? What problem are you solving? Why is what you are suggesting better than what's already there?

## Working on eos-system-contracts
## Working on system-contracts

Code contributions are welcome and encouraged! If you are looking for a good place to start, check out the [good first issue](https://github.com/eosnetworkfoundation/eos-system-contracts/labels/good%20first%20issue) label in GitHub issues.
Code contributions are welcome and encouraged! If you are looking for a good place to start, check out the [good first issue](https://github.com/VaultaFoundation/system-contracts/labels/good%20first%20issue) label in GitHub issues.

Also, please follow these guidelines when submitting code:

### Feature Branches

To get it out of the way:

- **[main](https://github.com/eosnetworkfoundation/eos-system-contracts/tree/main)** is the development branch. All work on the next release happens here so you should generally branch off `main`. Do **NOT** use this branch for a production site.
- **release/** branches contain stable releases of eos-system-contracts. Some of these branches may be obsolete, a prerelease (release candidate), or designated as stable and ready for use in production. Generally do **NOT** use these branches to work on eos-system-contracts' source unless you are working on a defect or change that would apply to a current stable release or release candidate. If in doubt, branch off of `main` and an eos-system-contracts maintainer will chime in if you should switch to a release branch.
- **[main](https://github.com/VaultaFoundation/system-contracts/tree/main)** is the development branch. All work on the next release happens here so you should generally branch off `main`. Do **NOT** use this branch for a production site.
- **release/** branches contain stable releases of system-contracts. Some of these branches may be obsolete, a prerelease (release candidate), or designated as stable and ready for use in production. Generally do **NOT** use these branches to work on system-contracts' source unless you are working on a defect or change that would apply to a current stable release or release candidate. If in doubt, branch off of `main` and an system-contracts maintainer will chime in if you should switch to a release branch.

### Submitting Pull Requests

Expand All @@ -78,7 +78,7 @@ Pull requests are awesome. If you're looking to raise a PR for something which d

Never underestimate just how useful quality assurance is. If you're looking to get involved with the code base and don't know where to start, checking out and testing a pull request is one of the most useful things you could do.

Essentially, [check out the main branch](#working-on-eos-system-contracts), take it for a spin, and if you find anything odd, please follow the [bug report guidelines](#bug-reports) and let us know!
Essentially, [check out the main branch](#working-on-system-contracts), take it for a spin, and if you find anything odd, please follow the [bug report guidelines](#bug-reports) and let us know!

## Conduct

Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# EOS system contracts
# Vaulta system contracts

EOS system contracts are a collection of contracts specifically designed for the EOS blockchain, which implements a lot of critical functionality that goes beyond what is provided by the base Antelope protocol, the protocol on which EOS blockchain is built on.
Vaulta system contracts are a collection of contracts specifically designed for the Vaulta blockchain, which implements a lot of critical functionality that goes beyond what is provided by the base Antelope protocol, the protocol on which Vaulta blockchain is built on.

The Antelope protocol includes capabilities such as:

Expand Down Expand Up @@ -32,7 +32,7 @@ The collection of system contracts consists of the following individual contract

## Repository organization

The `main` branch contains the latest state of development; do not use this for production. Refer to the [releases page](https://github.com/eosnetworkfoundation/eos-system-contracts/releases) for current information on releases, pre-releases, and obsolete releases as well as the corresponding tags for those releases.
The `main` branch contains the latest state of development; do not use this for production. Refer to the [releases page](https://github.com/VaultaFoundation/system-contracts/releases) for current information on releases, pre-releases, and obsolete releases as well as the corresponding tags for those releases.
## Supported Operating Systems

[CDT](https://github.com/AntelopeIO/cdt) is required to build contracts. Any operating systems supported by CDT is sufficient to build the system contracts.
Expand Down
2 changes: 1 addition & 1 deletion build.sh
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ else
CDT_DIR_CMAKE_OPTION="-Dcdt_DIR=${CDT_INSTALL_DIR}/lib/cmake/cdt"
fi

printf "\t=========== Building eos-system-contracts ===========\n\n"
printf "\t=========== Building system-contracts ===========\n\n"
RED='\033[0;31m'
NC='\033[0m'
CPU_CORES=$(getconf _NPROCESSORS_ONLN)
Expand Down
4 changes: 2 additions & 2 deletions contracts/eosio.bpay/include/eosio.bpay/eosio.bpay.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -18,15 +18,15 @@ namespace eosio {
* ## TABLE `rewards`
*
* @param owner - block producer owner account
* @param quantity - reward quantity in EOS
* @param quantity - reward quantity in A (or other token)
*
* ### example
*
* ```json
* [
* {
* "owner": "alice",
* "quantity": "8.800 EOS"
* "quantity": "8.800 A"
* }
* ]
* ```
Expand Down
2 changes: 1 addition & 1 deletion contracts/eosio.fees/include/eosio.fees/eosio.fees.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ namespace eosio {
*
* This contract serves as an essential component for inclusion in system-level unit tests.
*
* A comprehensive implementation of the eosio.fees contract can be accessed at EOS Network Foundation GitHub repository.
* A comprehensive implementation of the eosio.fees contract can be accessed at Vaulta Foundation GitHub repository.
* https://github.com/eosnetworkfoundation/eosio.fees
*/
class [[eosio::contract("eosio.fees")]] fees : public contract {
Expand Down
16 changes: 8 additions & 8 deletions contracts/eosio.system/include/eosio.system/eosio.system.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -622,8 +622,8 @@ namespace eosiosystem {
// - `version` defaulted to zero,
// - `from` account creating and paying for loan,
// - `receiver` account receiving rented resources,
// - `payment` SYS tokens paid for the loan,
// - `balance` is the amount of SYS tokens available to be used for loan auto-renewal,
// - `payment` A tokens paid for the loan,
// - `balance` is the amount of A tokens available to be used for loan auto-renewal,
// - `total_staked` total amount staked,
// - `loan_num` loan number/id,
// - `expiration` the expiration time when loan will be either closed or renewed
Expand Down Expand Up @@ -770,7 +770,7 @@ namespace eosiosystem {
uint8_t version = 0;
int64_t weight = 0; // resource market weight. calculated; varies over time.
// 1 represents the same amount of resources as 1
// satoshi of SYS staked.
// satoshi of A staked.
int64_t weight_ratio = 0; // resource market weight ratio:
// assumed_stake_weight / (assumed_stake_weight + weight).
// calculated; varies over time. 1x = 10^15. 0.01x = 10^13.
Expand Down Expand Up @@ -1069,7 +1069,7 @@ namespace eosiosystem {
// functions defined in delegate_bandwidth.cpp

/**
* Delegate bandwidth and/or cpu action. Stakes SYS from the balance of `from` for the benefit of `receiver`.
* Delegate bandwidth and/or cpu action. Stakes A from the balance of `from` for the benefit of `receiver`.
*
* @param from - the account to delegate bandwidth from, that is, the account holding
* tokens to be staked,
Expand Down Expand Up @@ -1172,7 +1172,7 @@ namespace eosiosystem {
void cnclrexorder( const name& owner );

/**
* Rentcpu action, uses payment to rent as many SYS tokens as possible as determined by market price and
* Rentcpu action, uses payment to rent as many A tokens as possible as determined by market price and
* stake them for CPU for the benefit of receiver, after 30 days the rented core delegation of CPU
* will expire. At expiration, if balance is greater than or equal to `loan_payment`, `loan_payment`
* is taken out of loan balance and used to renew the loan. Otherwise, the loan is closed and user
Expand All @@ -1192,7 +1192,7 @@ namespace eosiosystem {
void rentcpu( const name& from, const name& receiver, const asset& loan_payment, const asset& loan_fund );

/**
* Rentnet action, uses payment to rent as many SYS tokens as possible as determined by market price and
* Rentnet action, uses payment to rent as many A tokens as possible as determined by market price and
* stake them for NET for the benefit of receiver, after 30 days the rented core delegation of NET
* will expire. At expiration, if balance is greater than or equal to `loan_payment`, `loan_payment`
* is taken out of loan balance and used to renew the loan. Otherwise, the loan is closed and user
Expand Down Expand Up @@ -1396,7 +1396,7 @@ namespace eosiosystem {
/**
* The buyramself action is designed to enhance the permission security by allowing an account to purchase RAM exclusively for itself.
* This action prevents the potential risk associated with standard actions like buyram and buyrambytes,
* which can transfer EOS tokens out of the account, acting as a proxy for eosio.token::transfer.
* which can transfer tokens out of the account, acting as a proxy for eosio.token::transfer. Token must include the symbol, example A.
*
* @param account - the ram buyer and receiver,
* @param quant - the quantity of tokens to buy ram with.
Expand Down Expand Up @@ -1678,7 +1678,7 @@ namespace eosiosystem {
* @pre If proxy is set then proxy account must exist and be registered as a proxy
* @pre Every listed producer or proxy must have been previously registered
* @pre Voter must authorize this action
* @pre Voter must have previously staked some EOS for voting
* @pre Voter must have previously staked tokens for voting (example A tokens)
* @pre Voter->staked must be up to date
*
* @post Every producer previously voted for will have vote reduced by previous vote weight
Expand Down
2 changes: 1 addition & 1 deletion contracts/eosio.system/src/rex.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -1042,7 +1042,7 @@ namespace eosiosystem {
asset system_contract::add_to_rex_pool( const asset& payment )
{
/**
* If CORE_SYMBOL is (EOS,4), maximum supply is 10^10 tokens (10 billion tokens), i.e., maximum amount
* If CORE_SYMBOL is (A,4), maximum supply is 10^10 tokens (10 billion tokens), i.e., maximum amount
* of indivisible units is 10^14. rex_ratio = 10^4 sets the upper bound on (REX,4) indivisible units to
* 10^18 and that is within the maximum allowable amount field of asset type which is set to 2^62
* (approximately 4.6 * 10^18). For a different CORE_SYMBOL, and in order for maximum (REX,4) amount not
Expand Down
10 changes: 5 additions & 5 deletions docs/01_key-concepts/01_system.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,24 +2,24 @@
title: System contracts, system accounts, privileged accounts
---

At the genesis of the EOS blockchain, there was only one account present, `eosio` account, which was and still is the main `system account`. During the EOS blockchain bootstrap process other `system account`s, were created by `eosio` account, which control specific actions of the `system contract`s. You can see them listed in the [About System Contract](../index.md#system-contracts-defined-in-eos-system-contracts) section.
At the genesis of the Vaulta blockchain, there was only one account present, `eosio` account, which was and still is the main `system account`. During the Vaulta blockchain bootstrap process other `system account`s, were created by `eosio` account, which control specific actions of the `system contract`s. You can see them listed in the [About System Contract](../index.md#system-contracts-defined-in-system-contracts) section.

__Note__ the terms `system contract` and `system account`. `Privileged accounts` are accounts which can execute a transaction while skipping the standard authorization check. To ensure that this is not a security hole, the permission authority over these accounts is granted to `eosio.prods` system account.

As you just learned the relation between a `system account` and a `system contract`, it is also important to remember that not all system accounts contain a system contract, but each system account has important roles in the blockchain functionality, as follows:

|Account|Privileged|Has contract|Description|
|---|---|---|---|
|eosio|Yes|It contains the `eosio.system` contract|The main system account on the EOS blockchain.|
|eosio|Yes|It contains the `eosio.system` contract|The main system account on the Vaulta blockchain.|
|eosio.msig|Yes|It contains the `eosio.msig` contract|Allows the signing of a multi-sig transaction proposal for later execution if all required parties sign the proposal before the expiration time.|
|eosio.wrap|Yes|It contains the `eosio.wrap` contract.|Simplifies block producer superuser actions by making them more readable and easier to audit.|
|eosio.token|No|It contains the `eosio.token` contract.|Defines the structures and actions allowing users to create, issue, and manage tokens on the EOS blockchain.|
|eosio.token|No|It contains the `eosio.token` contract.|Defines the structures and actions allowing users to create, issue, and manage tokens on the Vaulta blockchain.|
|eosio.names|No|No|The account which is holding funds from namespace auctions.|
|eosio.bpay|No|No|The account that pays the block producers for producing blocks. It assigns 0.25% of the inflation based on the amount of blocks a block producer created in the last 24 hours.|
|eosio.prods|No|No|The account representing the union of all current active block producers permissions.|
|eosio.ram|No|No|The account that keeps track of the EOS balances based on users actions of buying or selling RAM.|
|eosio.ram|No|No|The account that keeps track of the Vaulta balances based on users actions of buying or selling RAM.|
|eosio.ramfee|No|No|The account that keeps track of the fees collected from users RAM trading actions: 0.5% from the value of each trade goes into this account.|
|eosio.saving|No|No|The account which holds the 4% of network inflation.|
|eosio.stake|No|No|The account that keeps track of all EOS tokens which have been staked for voting.|
|eosio.stake|No|No|The account that keeps track of all Vaulta tokens which have been staked for voting.|
|eosio.vpay|No|No|The account that pays the block producers accordingly with the votes won. It assigns 0.75% of inflation based on the amount of votes a block producer won in the last 24 hours.|
|eosio.rex|No|No|The account that keeps track of fees and balances resulted from REX related actions execution.|
4 changes: 2 additions & 2 deletions docs/01_key-concepts/02_system_resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: System Resources
---

The EOS blockchain works with three system resources: CPU, NET and RAM. The EOS accounts need sufficient system resources to interact with the smart contracts deployed on the blockchain.
The Vaulta blockchain works with three system resources: CPU, NET and RAM. The Vaulta accounts need sufficient system resources to interact with the smart contracts deployed on the blockchain.

* [RAM Resource](./05_ram.md)
* [CPU Resource](./03_cpu.md)
Expand All @@ -15,7 +15,7 @@ To allocate CPU and NET resources to an account you have to [power up the accoun

As a developer if you want to estimate how much CPU and NET a transaction requires for execution, you can employ one of the following methods:

* Use the `--dry-run` option for the `dune -- cleos push transaction` command.
* Use the `--dry-run` option for the `cleos push transaction` command.
* Use any tool that can pack a transaction and send it to the blockchain and specify the `--dry-run` option.
* Use the chain API endpoint [`compute_transaction`](https://github.com/AntelopeIO/spring/blob/7254bab917a17bcc0d82d23d03f4173176150239/plugins/chain_plugin/include/eosio/chain_plugin/chain_plugin.hpp#L557).

Expand Down
Loading