NODE

RUNNING A NODE

Verification of emission transactions by UNN requires a user to configure a connection to Ethereum JSON-RPC API provider. This can be either instance of some Ethereum client or third-party services like Infura
The corresponding setting is located in Settings.xon file under 'Nas' section:

Nas
{
    ...
    Provider = 'url_to_Ethereum_REST_API_provider'
    ...
}

OS firewall should be configured to allow incoming connections for TCP ports 3080 (and 3081 for receiving and processing incoming transactions). In case if a machine with running UNN is connected to the Internet through a router then the user needs to configure port forwarding (NAT) for 3080 (and 3081 for receiving and processing incoming transactions) port(s) in his router's settings. Check your router manual for specific instructions.

If user intends to participate in block generation then this requires from him to perform the following steps:

1. Create account using GUI or 'account new' or 'account import' command
2. Deposit some funds (bigger amount gives higher chances to be elected as a member) to this account using 'emission emit' or 'unt transfer' command. This funds will be used as a bail.
3. Configure a candidate account in the Settings.xon. Full mode requires to keep a password as a plain text so use it in safe environments only.

    ...
    Candidate = 'candidate_account'
    CandidatePassword = 'candidate_account_password'
    ...

4. Now, a node can be run by launching 'unnc' executable using the following command:

unnc node

Also, Windows users can run a node with graphical UI by launching the following executable:

UC.Net.Node.FUI.exe

COMMON ARGUMENTS

fpbmax - a maximum cost of one byte in UNT for any supported transactions

CANDIDACY

The "decare" command is used to declare specified account as a potential member of block generators.

unnc candidacy declare account=... [password=...] bail=... fpb=... rpcurl=...

accountUltranet account public address that candidate is going use to sign its blocks.
passwordA password to account above. If password is not set then it will be asked during an execution of the command.
amountAmount of ETH to used as bail. The bail will be subtracted from account balance and locked. A candidate can change its bail by sending subsequent "candidacy declare" command with bigger or smaller bail amount or zero to cancel his declaration and deposit last locked bail back
fpbA fixed fee per byte that transaction senders are required to pay if they delegate their transactions to this member
rpcurlFully-qualified url of JSON RPC end-point of candidate's node server. Overrides candidate's node current IP address and default (3081) JSON RPC port.

Example:

unnc candidacy declare account=0x0000fffb3f90771533b1739480987cee9f08d754 password=thesuccessoroftheweb bail=1.000 fpb=0.000001 rpcurl=http://12.34.56.78:3081 fpbmax=0.000001

UNT EMIT

The "emit" command is used to convert ETH tokens in Ethereum network to UNT tokens in Ultranet network. The final amount of UNT depends on current Emission Factor.

unnc unt emit from {wallet=... [password=...] amount=...} to {account=... [password=...]}

from {...walletEthereum .json wallet file of account where funds are debited from.
passwordA password to wallet file above. If password is not set then it will be asked during an execution of command.
amountAmount of ETH to convert into UNT
to {...accountUltranet account public address where funds are credited to using current UNT Emission Factor ratio.
passwordA password to account above. If password is not set then it will be asked during an execution of command.

Example:

unnc unt emit from {wallet=C:\aaaabbbbccccddddd111122223333.json password=thesuccessoroftheweb amount=1.500} to {account=0x0000fffb3f90771533b1739480987cee9f08d754 password=thesuccessoroftheweb} fpbmax=0.000001

UNT TRANSFER

The "transfer" command is used to send UNT tokens form one account to another.

unt transfer from=... [password=...] to=... amount=...

fromAccount public address where funds are debited from
passwordA password to account above. If password is not set then it will be asked during an execution of the command.
toAccount public address where funds are credited to
amountAmount of UNT to transfer

Example:

unt transfer from=0x0000fffb3f90771533b1739480987cee9f08d754 password=thesuccessoroftheweb to=0x1111dae119f210c94b4cf99385841fea988fcfca amount=1.000 fpbmax=0.000001