Colorcore - Revision history

Flavos at 21:38, 6 September 2014

2014-09-06T21:38:28Z

← Older revision		Revision as of 21:38, 6 September 2014
Line 3:		Line 3:
	It supports two modes: a command line interface, and a JSON/RPC server. The command line interface is suitable for managing a local wallet without going through any third-party service. The JSON/RPC interface is suitable for server-side implementations of colored coins and programmatic colored coins wallet management.		It supports two modes: a command line interface, and a JSON/RPC server. The command line interface is suitable for managing a local wallet without going through any third-party service. The JSON/RPC interface is suitable for server-side implementations of colored coins and programmatic colored coins wallet management.

	Open Assets is a protocol for issuing and transferring custom digital tokens in a secure way on the Bitcoin blockchain (or any compatible blockchain).		[[Colored Coins#Open_Assets\|Open Assets]] is a protocol for issuing and transferring custom digital tokens in a secure way on the Bitcoin blockchain (or any compatible blockchain).

	==Features==		==Features==

Flavos at 21:38, 6 September 2014

2014-09-06T21:38:00Z

← Older revision		Revision as of 21:38, 6 September 2014
Line 1:		Line 1:
	[https://github.com/OpenAssets/colorcore Colorcore] is an open source [[Colored Coins]] wallet compatible with the [[Colored Coins#Open_Assets\|Open Assets protocol]] and [[Coinprism]].		[https://github.com/OpenAssets/colorcore Colorcore] is an open source [[Colored Coins]] wallet compatible with the [[Colored Coins#Open_Assets\|Open Assets protocol]] and [[Coinprism]].

			It supports two modes: a command line interface, and a JSON/RPC server. The command line interface is suitable for managing a local wallet without going through any third-party service. The JSON/RPC interface is suitable for server-side implementations of colored coins and programmatic colored coins wallet management.

	~~It supports two modes:~~ a ~~command line interface,~~ and a ~~JSON/RPC server. The command line interface is suitable for managing a local wallet without going through~~ any ~~third-party service. The JSON/RPC interface is suitable for server-side implementations of colored coins and programmatic colored coins wallet management~~.		Open Assets is a protocol for issuing and transferring custom digital tokens in a secure way on the Bitcoin blockchain (or any compatible blockchain).

	==Features==		==Features==

Flavos at 21:37, 6 September 2014

2014-09-06T21:37:05Z

← Older revision		Revision as of 21:37, 6 September 2014
Line 1:		Line 1:
	[https://github.com/OpenAssets/colorcore Colorcore] is an open source [[Colored Coins]] wallet compatible with the [[Colored Coins#Open_Assets\|Open Assets protocol]] and [[Coinprism]].		[https://github.com/OpenAssets/colorcore Colorcore] is an open source [[Colored Coins]] wallet compatible with the [[Colored Coins#Open_Assets\|Open Assets protocol]] and [[Coinprism]].


			It supports two modes: a command line interface, and a JSON/RPC server. The command line interface is suitable for managing a local wallet without going through any third-party service. The JSON/RPC interface is suitable for server-side implementations of colored coins and programmatic colored coins wallet management.

	==Features==		==Features==

Flavos: /* License */

2014-09-06T17:54:24Z

License

← Older revision		Revision as of 17:54, 6 September 2014
Line 74:		Line 74:

	==License==		==License==
	Colorcore is licensed under the MIT License.		Colorcore is licensed under the [http://opensource.org/licenses/MIT MIT License].

	==External Links==		==External Links==

Flavos: /* License */

2014-09-06T17:53:56Z

License

← Older revision		Revision as of 17:53, 6 September 2014
Line 74:		Line 74:

	==License==		==License==
	~~[https://github.com/OpenAssets/colorcore~~ Colorcore] is licensed under the MIT License.		Colorcore is licensed under the MIT License.

	==External Links==		==External Links==

Flavos at 17:53, 6 September 2014

2014-09-06T17:53:39Z

← Older revision		Revision as of 17:53, 6 September 2014
Line 72:		Line 72:

	* [[Coinprism]] launches [https://github.com/OpenAssets/colorcore Colorcore], an open source colored coin wallet compatible with open assets and Coinprism: September 2nd 2014 <ref>[http://www.reddit.com/r/Bitcoin/comments/2f9sfy/announcing_colorcore_the_open_source_colored_coin/ Colorcore: the colored coin wallet compatible with open assets]</ref>		* [[Coinprism]] launches [https://github.com/OpenAssets/colorcore Colorcore], an open source colored coin wallet compatible with open assets and Coinprism: September 2nd 2014 <ref>[http://www.reddit.com/r/Bitcoin/comments/2f9sfy/announcing_colorcore_the_open_source_colored_coin/ Colorcore: the colored coin wallet compatible with open assets]</ref>

			==License==
			[https://github.com/OpenAssets/colorcore Colorcore] is licensed under the MIT License.

	==External Links==		==External Links==
Line 88:		Line 91:
	* [http://reddit.com/r/coinprism Coinprism on Reddit] Coinprism subreddit		* [http://reddit.com/r/coinprism Coinprism on Reddit] Coinprism subreddit
	* [http://www.crunchbase.com/organization/coinprism/ Crunchbase profile] Crunchbase		* [http://www.crunchbase.com/organization/coinprism/ Crunchbase profile] Crunchbase

	~~==Founder==~~
	~~Flavien Charlon~~

	==References==		==References==

Flavos: /* Installation and dependencies */

2014-09-06T17:51:35Z

Installation and dependencies

← Older revision		Revision as of 17:51, 6 September 2014
Line 22:		Line 22:
	cd colorcore		cd colorcore
	pip install --upgrade -r requirements.txt		pip install --upgrade -r requirements.txt


	* Edit the config.ini file with the username, password and port for your local Bitcoin Core instance (rpcurl setting).		* Edit the config.ini file with the username, password and port for your local Bitcoin Core instance (rpcurl setting).

Flavos: /* How to use Colorcore? */

2014-09-06T17:51:08Z

How to use Colorcore?

← Older revision		Revision as of 17:51, 6 September 2014
Line 31:		Line 31:
	*'''Get your balance'''<br/>		*'''Get your balance'''<br/>
	Run the following command to get your balance:<br/>		Run the following command to get your balance:<br/>
	python colorcore.py getbalance~~<br/>~~		python colorcore.py getbalance
	[[Image:Colorcore_1.png‎‎\|400px]]<br/>		[[Image:Colorcore_1.png‎‎\|400px]]<br/>
	All the addresses with a non-zero balance on your Bitcoin Core wallet will be displayed. The 'assets' field will show how much assets you have. If you don't have any asset, it will be empty. Each asset has a 'assetAddress' field as well as a 'quantity' field. 'assetAddress' is what identifies the asset. It is cryptographically secure, and it is impossible for two people to be owner of the same asset address. 'quantity' is an integer indicating how many units of that asset you own.<br/>		All the addresses with a non-zero balance on your Bitcoin Core wallet will be displayed. The 'assets' field will show how much assets you have. If you don't have any asset, it will be empty. Each asset has a 'assetAddress' field as well as a 'quantity' field. 'assetAddress' is what identifies the asset. It is cryptographically secure, and it is impossible for two people to be owner of the same asset address. 'quantity' is an integer indicating how many units of that asset you own.<br/>

Flavos: /* How to use Colorcore? */

2014-09-06T17:50:47Z

How to use Colorcore?

← Older revision		Revision as of 17:50, 6 September 2014
Line 31:		Line 31:
	*'''Get your balance'''<br/>		*'''Get your balance'''<br/>
	Run the following command to get your balance:<br/>		Run the following command to get your balance:<br/>
	~~<code>~~ python colorcore.py getbalance~~</code>~~<br/>		python colorcore.py getbalance<br/>
	[[Image:Colorcore_1.png‎‎\|400px]]<br/>		[[Image:Colorcore_1.png‎‎\|400px]]<br/>
	All the addresses with a non-zero balance on your Bitcoin Core wallet will be displayed. The 'assets' field will show how much assets you have. If you don't have any asset, it will be empty. Each asset has a 'assetAddress' field as well as a 'quantity' field. 'assetAddress' is what identifies the asset. It is cryptographically secure, and it is impossible for two people to be owner of the same asset address. 'quantity' is an integer indicating how many units of that asset you own.<br/>		All the addresses with a non-zero balance on your Bitcoin Core wallet will be displayed. The 'assets' field will show how much assets you have. If you don't have any asset, it will be empty. Each asset has a 'assetAddress' field as well as a 'quantity' field. 'assetAddress' is what identifies the asset. It is cryptographically secure, and it is impossible for two people to be owner of the same asset address. 'quantity' is an integer indicating how many units of that asset you own.<br/>
Line 37:		Line 37:
	First, you need to create an address in Bitcoin Core. This address will represent your asset, and the private key associated will be required for any issuance of the asset. Note that the protocol supports multi-sig addresses for issuance, though that is not implemented in Colorcore 1.0.		First, you need to create an address in Bitcoin Core. This address will represent your asset, and the private key associated will be required for any issuance of the asset. Note that the protocol supports multi-sig addresses for issuance, though that is not implemented in Colorcore 1.0.
	Run the following command on bitcoind (not Colorcore):<br/>		Run the following command on bitcoind (not Colorcore):<br/>
	~~<code>~~ bitcoind getnewaddress~~</code><br />~~		bitcoind getnewaddress
	This will generate a private key and return the address. Make sure your wallet.dat file is properly backed up.		This will generate a private key and return the address. Make sure your wallet.dat file is properly backed up.
	Now transfer a small amount of bitcoins (0.0002 BTC is enough) to that newly created address.		Now transfer a small amount of bitcoins (0.0002 BTC is enough) to that newly created address.
	Run the following command to issue one million colored coins:<br/>		Run the following command to issue one million colored coins:<br/>
	~~<code>~~ python colorcore.py issueasset <address> 1000000~~</code><br/>~~		python colorcore.py issueasset <address> 1000000
	You can issue up to 9,223,372,036,854,775,807 colored coins at once. Unlike older colored coins implementations, you only need 0.000006 BTC for issuing coins, regardless of the quantity you want to issue.		You can issue up to 9,223,372,036,854,775,807 colored coins at once. Unlike older colored coins implementations, you only need 0.000006 BTC for issuing coins, regardless of the quantity you want to issue.
	This command will return a transaction hash. You can look up that transaction hash on the [[Coinprism.info]] block explorer.		This command will return a transaction hash. You can look up that transaction hash on the [[Coinprism.info]] block explorer.
Line 47:		Line 47:
	Of course, this is not very useful if you can't identify what asset is what. In order to link information such as a name to your coin, you need to create a metadata file, and host it on your web server. Of course, this doesn't introduce centralization since you are already the issuer of the coin, and the value of your coin (if any) already comes from you. Since you are responsible for the value of the coin you are issuing, it is not an issue if you also host the information about this coin. The metadata file is a JSON file and contains the following information:		Of course, this is not very useful if you can't identify what asset is what. In order to link information such as a name to your coin, you need to create a metadata file, and host it on your web server. Of course, this doesn't introduce centralization since you are already the issuer of the coin, and the value of your coin (if any) already comes from you. Since you are responsible for the value of the coin you are issuing, it is not an issue if you also host the information about this coin. The metadata file is a JSON file and contains the following information:
	<br />		<br />
	~~<code>~~		{"source_addresses": [
	{"source_addresses": [
	"source address for the coin (can be obtained from the getbalance call)"		"source address for the coin (can be obtained from the getbalance call)"
	],		],
	"contract_url": "https://yoursite.com/more-info-about-the-coin",		"contract_url": "https://yoursite.com/more-info-about-the-coin",
	"name_short": "ICECC",		"name_short": "ICECC",
	"name": "The Ice Cream Coin",		"name": "The Ice Cream Coin",
	"issuer": "Vanilla Inc",		"issuer": "Vanilla Inc",
	"description": "This coin is worth an ice cream at any Vanilla Inc shop.",		"description": "This coin is worth an ice cream at any Vanilla Inc shop.",
	"description_mime": "text/x-markdown; charset=UTF-8",		"description_mime": "text/x-markdown; charset=UTF-8",
	"type": "Points",		"type": "Points",
	"divisibility": 0,		"divisibility": 0,
	"link_to_website": true,		"link_to_website": true,
	"icon_url": "https://yoursite.com/coin-icon.jpg",		"icon_url": "https://yoursite.com/coin-icon.jpg",
	"image_url": "https://yoursite.com/coin-image.jpg",		"image_url": "https://yoursite.com/coin-image.jpg",
	"version": "1.0"}		"version": "1.0"
	~~</code>~~		}

	The assuming you have placed that file at: https://yoursite.com/icecream, use the following argument when issuing the coins:		The assuming you have placed that file at: https://yoursite.com/icecream, use the following argument when issuing the coins:
	~~<code>~~ python colorcore.py issueasset <address> 1000000 --metadata u=https://yoursite.com/icecream~~</code><br />~~		python colorcore.py issueasset <address> 1000000 --metadata u=https://yoursite.com/icecream
	You can then lookup the color address on [[Coinprism.info]], and you should see all that information.		You can then lookup the color address on [[Coinprism.info]], and you should see all that information.
	<br />		<br />
	Only the URL (https://yoursite.com/icecream) is stored on the Blockchain.		Only the URL (https://yoursite.com/icecream) is stored on the Blockchain.

	==History==		==History==

Flavos: /* Installation and dependencies */

2014-09-06T17:49:28Z

Installation and dependencies

← Older revision		Revision as of 17:49, 6 September 2014
Line 22:		Line 22:
	cd colorcore		cd colorcore
	pip install --upgrade -r requirements.txt		pip install --upgrade -r requirements.txt
	~~<br />~~

	* Edit the config.ini file with the username, password and port for your local Bitcoin Core instance (rpcurl setting).		* Edit the config.ini file with the username, password and port for your local Bitcoin Core instance (rpcurl setting).