Byteball Wiki

"Asset" in financial community = "token" in non-financial community.

There is a separate Token article that concentrates on the four kinds of tokens on the Byteball platform with zero or tiny monetary value, rather than those used more financially.

From white paper[]

Users can issue new assets and define rules that govern their transferability. The rules can include spending restrictions such as a requirement for each transfer to be cosigned by the issuer of the asset, which is one way for financial institutions to comply with existing regulations. Users can also issue assets whose transfers are not published to the database, and therefore not visible to third parties. Instead,the information about the transfer is exchanged privately between users, and only a hash of the transaction and a spend proof (to prevent double-spends) are published to the database.[1]

Byteball Asset Manager[]


 Here you can create your own token/asset. You must also register[2] it before the name (instead of the hash) will display in a wallet.

  • Example name: Zwib by Jore Bohne
  • Example hash: ZWlbZhl6C9IsV3biDC+ngzsLq58mQ0hbwWyLBLpFLQc=

Why are you creating a token?[]

It is important to work out the purpose of a token before you start to create it. There can be both frivolous/trivial reasons -- where it is probably better not to create the token after all -- and serious ones where you go ahead. Examples:

Trivial reasons[]

  • I want to see if it works: It does work. Really.
  • I want to have coins in my wallet in addition to bytes and blackbytes: Download some fun-coins from the free faucet in your wallet Bot Store.
  • I want to see my name in the wallet: You can do this in a wallet updated to a recent version (2.0+), but first you need to get a Name Registry to verify your identity, and then register the token.

Serious reasons[]

  • As part of a well-conceived business plan: But think it through. People with zero experience using a crypto wallet are not likely to embrace the idea of exchanging Byteball tokens in any business setting. Maybe in a few years from now, but not currently.
  • Family tokens, social tokens: See the token page for details.

The fields in the application form[]

Cap (money supply): Defaults to 1000, but can be between 1 and 10^15. You can only create a token with this unique hash once, so think carefully how many you need.

Auto-destroy: If you check this box, it means that any new asset/token sent to its defining address become unspendable, like sending something to a black hole.

Add asset details to asset directory: Look at an asset directory example[3] to see what this means.

Short name: This would be the "Credits" part of "Credits by Jore Bohne".

Decimals: Important! If you do not register the token, these will not display at all. So if you order 1000 coins with 5 decimals, you would get 1000 coins formatted as 0.10000. If you do register the coin, it will display with 5 decimals, and you cannot change this to 0 or 2 decimals. If you do not have a good purpose for decimals, leave it as the default 0.

Ticker: Limited to 5 characters, so for "Credits by John Bohne" he chose "CREDS".

Description: Put your purpose for the coin. There is no need to disclose confidential parts of your business plan, but be as helpful as possible to people who will look this up.

Issuer name: In "Credits by Jore Bohne" this is "Jore Bohne". You may want to use the name that gives the most credibility to your token. If you have verified your identity with the Byteball bot, it is best to use that name. A name registry can easily use that verified identity to register you as a coin issuer.

Name registries[]


This registry is operated by Peter Miklos who also runs Byteball Asset Manager[4] and a similar bot. Contact Peter directly on Slack[5] or on Twitter[6] to register your token.

  • Registration policy.[7]
  • A recent registration record.[8]

New assets[]

  • Clicking the link will take you to the unit page, where you can see how the asset/token is defined.

Some examples:

Asset Contact Notes
Zwibs [9] @slackjore first new asset on platform
CK1[10] @cryptkeeper community asset with membership-like features like special discounts at webshops
Scamcups[11] @chainsaw first asset with great random name in hash (LScaMCup...)

Titan Coin[]

See Wiki article Chatbot Section TitanCoin ICO for details

SilentNotary by Sigany Ltd[]


See Wiki article Chatbot Section SilentNotary ICO for details

Just do it[]

You can simply send your new (unrestricted) assets/tokens to any Byteball address, with no chat or contract needed. Copy the address, open the send tab, find the asset/token in your drop-down box, paste the address, enter the amount (in whole numbers), and click Send. Perfect for confusing people who aren't expecting to receive 25 Zingos in their wallet!

Caution: Be careful to send the right asset/token. Don't send someone 4 GB by mistake when you mean to send 4 Zingos. Not joking. Double-check.


With wallet version 2.1, you can send any public asset -- including your newly-created one -- by textcoin.

Transaction fees[]

Usual transaction fees apply. So sending 9 Zingos somewhere will cost 750 bytes, or whatever. At 1GB = $750, 1MB = $0.75, 1KB = $0.00075, and 750 bytes = $0.0005 so you won't go broke.

Change address[]

See the wiki change address article if you're not sure how these work and apply here.

New assets/tokens in your wallet[]

You started off with 0 bytes in your wallet. Later, you probably got some bytes, and maybe some blackbytes. At present, maybe some Zwibs and/or something else. If you click the Send tab, you'll see you a drop-down menu, and you can spend from any of your asset types.

Note that these listed asset/token types remain, even if the balance of one particular asset/token is zero. So every time someone receives some Zingos, the Zingo asset/token type gets added to their wallet asset/token list, indelibly so for now. After a few of these, if you don't really want them, they act as spam.

So, please don't send your new assets/tokens to someone without asking them first if they want them. :)


There is an asset/token directory[12] where you can view details of the new assets/tokens.

Fractional ownership[]

Fractional ownership is a method in which several unrelated parties can share in, and mitigate the risk of, ownership of a high-value tangible asset, usually a jet, yacht or piece of resort real estate. It can be done for strictly monetary reasons, but typically there is some amount of personal access involved. One of the main motivators for a fractional purchase is the ability to share the costs of maintaining an asset that will not be used full-time by one owner. Every fractional endeavour requires some sort of management, to administer the rules and regulations (which are agreed upon before the fraction is purchased) and maintain the asset to the degree laid out in the ownership documents.[13]


Tokenization is the process of converting fractional-ownership rights to an asset into a digital token on a distributed ledger. There is great interest by financial intermediaries and technologists around the world in figuring out how to move real-world assets onto blockchains to gain the advantages of cryptocurrencies while keeping the characteristics of the asset.[14]

Byteball tokens[]

Could the Byteball platform be utilised in various fractional-ownership schemes? Possibly. But management, asset security and maintenance etc, complicate the picture. It would not be as straightforward as the uses seen so far. 

ICO bot[]

TitanCoin is the first use of our ICO bot which was published on github just recently.[15] The bot is designed to help entrepreneurs raise funds and distribute their tokens, easily and securely. The current version (2018-01-07) now accepts BTC and ETH in addition to Bytes. The tokens are issued immediately after the payment is confirmed.

Identity verification for ICOs[]

Identity verification is now (after 18 January 2018) possible in your Byteball wallet, where you can selectively reveal some or all of name, date of birth, country, ID number, ID type to a coin issuer. The general process links a real-world identity to a specific single-address wallet, so you can still be anonymous to the coin-issuer but the coin-issuer can be confident that your real-world identity is attested. This has important KYC implications.

The ICO craze[]


Ethereum Q&A ICOs, disruption, and self-regulation

This must-watch 9-minute video from Andreas Antonopoulos explains how ICOs will disrupt financial technology all across the spectrum; how almost all ICOs currently are bad; how regulators will try but won't be able to keep with new innovations and their rules will be unenforceable anyway; how society has to wade through hundreds of losing imvestments in order to finally learn what is a good ICO investment.


Be aware that fundraising via new assets/tokens on cryptocurrency platforms, sometimes issued as ICOs (Initial Coin Offerings), are increasingly being regulated in various nations. For a general overview of this by country, see here[16].


On July 25, 2017, the US SEC (Securities and Exchange Commission) issued a report[17] stating that offers and sales of digital assets by "virtual" organizations are subject to the requirements of the federal securities laws. The key points from this are that:

  • Digital assets can be securities
  • That determination will depend on the facts and circumstances of each case (see Howey)
  • Digital assets that are deemed securities are subject to U.S. securities laws.

The third point is extremely broad because securities laws are very extensive.

Howey Test[]

Excerpted from "What is the Howey Test?[18]:

Whether a particular investment transaction involves the offer or sale of a security – regardless of the terminology or technology used – will depend on the facts and circumstances, including the economic realities of the transaction.

Under the Howey Test, a transaction is an investment contract (and thus subject to securities registration requirements) if:

  • It is an investment of money
  • There is an expectation of profits from the investment
  • The investment of money is in a common enterprise
  • Any profit comes from the efforts of a promoter or third party

Refer to the linked article for further explanation of these four points. It might be a good idea to not use the word "investment" in describing your asset/token.


Does this apply to your token/asset? Depends. The US lately has been assuming a "World Police" function, whether sanctioned by international law or not. If in doubt, consult a competent lawyer.


On September 4, 2017, the People's Bank of China declared all ICOs (Initial Coin Offerings) illegal.[19] A report from September 10 said this may be "only temporary, until local financial regulators introduce necessary regulatory frameworks and policies for both ICO investors and projects."[20] How this applies to any new asset issued on the Byteball platform is not clear.

Bitcointalk copypasta[]


5/29 from tonych: Developer guide for issuing new assets on Byteball:

5/30 response: It's the same purpose as ethereum tokens, except the feature is built natively in Byteball and you don't need to write a smart-contract to manage the assets you emitted.

5/30 from tonych (post #8739): [Examples] ICOs, shares, bonds, fiat-pegged coins, loyalty points, minutes of airtime, assets in online games, whatever you can imagine. [How traded and where] They can be immediately traded P2P via smart contracts (same as blackbytes).

External links[]


<references> Also we have a trustless exchange already prepared but not started yet.