[{"_1":2,"_161":-5,"_162":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_140":141},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_88":-5,"_89":90,"_129":-5,"_130":11,"_131":21,"_132":11,"_133":-5,"_134":11,"_135":-5,"_136":137,"_138":91,"_139":-7},"canonicalUrl","https://hub.docker.com/r/nannal/avalon/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","nannal","reponame","avalon","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":74,"_79":11,"_80":81,"_85":33,"_86":87},"categories",[],"content_types",[44],"image","date_registered","2018-10-04T20:00:51.220142Z","description","Docker container for the Avalon block chain","is_private","last_updated","2019-09-16T12:59:04.671277Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[56],"application/vnd.docker.container.image.v1+json","name","pull_count",8639,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# AVALON\n\n## Get a node running\n\n#### Dependencies\n* [MongoDB](https://mongodb.com)\n* [NodeJS](https://nodejs.org/en/download/) **v10** (LTS)\n* [ntpd](https://linux.die.net/man/8/ntpd) or any NTP alternative for your system. ntpd comes pre-installed on most linux distributions\n\n## Install and run an Avalon node\n* `npm install` to install nodejs dependencies\n* Get your own keys with `node src/cli.js keypair`\n* Save your keys\n* Add your keys to `scripts/start.sh`\n* `chmod +x scripts/start.sh`\n* `./scripts/start.sh`\n\n### Environment Variables\nThe `start.sh` shows the list of available environment variables you can set to make avalon behave slightly differently from the default install.\n\n### Resetting and replaying the chain\n\n#### Full resync from peer to peer\nShut everything down, then `db.dropDatabase()` in mongo, and start the node. This will do a complete replay and verification of the chain. Depending on your CPU/RAM it might be extremely slow and take a long time on a long chain with many transactions.\n\n#### Replaying from a dump\nAn alternative way to resync your node faster is to use one of the backups provided by backup.d.tube. Example:\n\n```\nwget https://backup.d.tube/16.tar.gz\ntar xfvz ./16.tar.gz\nmongorestore -d avalon .\n```\n\nWill download and restore your avalon node up to 16:00 UTC.\n\n#### Creating your own dumps\nAlternatively, if you do not want to have to trust our backups, feel free to create your own as such:\n```\nmongodump -d avalon -o ~/avalon-backup/\n```\n\n#### Declaring your public node in your account profile\nIt is strongly recommended for all leaders to add a `node.ws` field to your profile as so:\n```\nnode src/cli.js profile -K -M '{\"node\":{\"ws\":\"ws://yourip:yourport\"}}'\n```\n\n## Get helped\nWe have a discord channel dedicated to node owners (aka leaders), where you can get support to get set up. Join [discorg.gg/dtube](https://discord.gg/dtube) and go to `DTube Chain -> #leader-candidates`\n\n## Using Avalon\n\n### With CLI\nYou can use the CLI tool to transact with avalon. Simply try `node src/cli --help` or `node src/cli --help` for a full help.\n\n### Using Javalon\n[Javalon](https://www.npmjs.com/package/javalon) is the javascript wrapper for avalon's API. Working on both browser and nodejs.\n\n### HTTP API\n\nAvalon's API uses 100% JSON. The GET calls will allow you to fetch the public information which is already available through the d.tube UI.\n\nExamples:\n* Account data: /account/:username, i.e https://avalon.d.tube/account/rt-international\n* Video data: /content/:username/:link i.e. https://avalon.d.tube/content/rongibsonchannel/QmdjVMdeTtTEy1CJTDbtjuaiRKMP6H364Dv4n7FsWGpnPH\n\n### Full list of API endpoints\n[https://docs.google.com/spreadsheets/d/1ORoHjrdq5V5OkTChijTUOEYRzTujVXTzCyNYt-ysVhw/edit?usp=drive_web&ouid=109732502499946497195](https://docs.google.com/spreadsheets/d/1ORoHjrdq5V5OkTChijTUOEYRzTujVXTzCyNYt-ysVhw/edit?usp=drive_web&ouid=109732502499946497195)\n\nThis lists all the available API endpoints for Avalon. We also have recommended security practises if you want to open your node's API to the world. You can do it easily with nginx and [avalon-nginx-config](https://github.com/dtube/avalon-nginx-config)\n\n### Transacting (POST /transact)\nOnce you have an account and balance, your account will start generating bandwidth and voting power (respectively the bw and vt fields in your account data). You can consume those ressources by transacting.\n\nEvery transactions will have a bandwidth cost, calculated based on the number of bytes required for the storage of fyour transaction in a block.\nCertain transaction types will require you to spend voting power, such as publishing a content, voting or tagging a content.\n\nTo transact, you need to use the /transact POST call of the Avalon API.\n\nNecessary for all transactions:\n* *key*: your private key\n* * Use -K MyKeyHere to use a plain-text key\n* * Or use -F file.json to use a key inside a file to sign (this will prevent your key from showing on the screen too much)\n* *user*: your username\n\n#### Vote for a leader\n* *target*: the node owner to approve\n```\nnode src/cli.js vote-leader -K -M \n\n// alice votes for bob as a leader\nnode src/cli.js vote-leader -K 5DPwDJqTvMuykHimmZxThfKttPSNLzJjpbNtkGNnjPAf -M alice bob\n```\n\n#### Unvote a leader\n* *target*: the node owner to approve\n```\nnode src/cli.js vote-leader -K -M \n\n// charlie does not want to vote for daniel as a leader anymore\nnode src/cli.js unvote-leader -F charlie_key.txt -M charlie daniel\n```\n\n#### Transfer tokens\n* *receiver*: username of the receiver of the transfer\n* *amount*: number of tokens to transfer to the receiver. Warning! 1 DTC in UI = 100 tokens\n* *memo*: arbitrary short text content\n```\nnode src/cli.js transfer -K -M \n// bob sends 50 DTC to charles\nnode src/cli.js transfer -K HkUbQ5YpejWVSPt8Qgz8pkPGwkDrMn3XECd4Asn3ANB3 -M bob charles 50 'thank you'\n```\n\n#### Add a post / Commenting\n* *link*: a short string to be used as the index of the content\n* *parent_author*: the username of the author of the parent post\n* *parent_link*: the link of the parent post\n* *json*: arbitrary json input. example: `{\"string\":\"aye\", array:[1,2,3]}`\n* *tag*: arbitrary short text content\n* *weight* : the number of vote tokens to spend on this vote\n```\nnode src/cli.js comment -K -M \n```\n\n#### Vote a post\n* *link*: the link of the post to vote on\n* *author*: the username of the author to vote on\n* *weight*: the number of vote tokens to spend on this vote\n* *tag*: arbitrary short text content\n```\nnode src/cli.js vote -K -M \n```\n\n#### Edit your user json object\n* *json*: arbitrary json input. example: `{\"string\":\"aye\", array:[1,2,3]}`\n```\nnode src/cli.js profile -K -M \n```\n\n#### Follow a user\n* *target*: the user to follow\n```\nnode src/cli.js follow -K -M \n```\n\n#### Unfollow a user\n* *target*: the user to unfollow\n```\nnode src/cli.js unfollow -K -M \n```\n\n#### Signing a raw transaction\n\nTo create a transaction and export it to a file, you can use the `sign` CLI tool\n```\nnode src/cli.js sign > tmptx.json\n```\nFor example to approve a node owner and publishing it only 5 seconds later:\n```\nnode src/cli.js sign -K 4L1C3553KRETK3Y -M alice '{\"type\":1,\"data\":{\"target\":\"miner1\"}}' > tmptx.json\nsleep 5\ncurl -H \"Content-type:application/json\" --data @tmptx.json http://localhost:3001/transact\n```\n\n### Other POST Calls\n\n#### Mine Block\nWill force the node to try to produce a block even if it's unscheduled. Useful for block #1 and working on development\n```\ncurl http://localhost:3001/mineBlock\n``` \n\n#### Add peer\nManually force connection to a peer without having to restart the node\n```\ncurl -H \"Content-type:application/json\" --data '{\"peer\" : \"ws://localhost:6001\"}' http://localhost:3001/addPeer\n```\n\n### Data storage\n\n### MongoDB\nAvalon saves the state of the chain into mongodb after each block. You can easily query mongodb directly to get any data you want, that wouldn't be provided by the API itself.\n```\nmongo \ndb.accounts.findOne({name:'master'})\ndb.blocks.findOne({_id: 0})\n```\nHowever be sure not to write to any collection used by avalon in this database (namely the accounts, blocks and contents). If you do, your node will irremediably fork sooner or later.\n\n### Elastic Search\nAvalon can also copy the accounts and contents into an elastic search database with [monstache](https://github.com/rwynn/monstache). A configuration file for monstache is provided in the root of this repository. Once running you can do text queries on accounts or contents like so: \n\n```\n# search contents\ncurl http://localhost:9200/avalon.contents/_search?q=football\n# search accounts\ncurl http://localhost:9200/avalon.accounts/_search?q=satoshi\n```\nPlease refer to Elastic Search documentation for more complex queries.\n\nD.Tube runs a public Elastic Search mirror of the current testnet on https://search.d.tube\n","has_starred","hub_user","immutable_tags_settings",{"_75":11,"_76":77},"enabled","rules",[78],".*","is_automated","permissions",{"_82":21,"_83":11,"_84":11},"read","write","admin","user","storage_size",4295901065,"orgData","recentTags",[91],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_50":118,"_119":94,"_120":33,"_121":56,"_57":122,"_123":124,"_125":109,"_126":118,"_127":66,"_128":21},"content_type","creator",3077168,"full_size",81024158,"id",36761515,"images",[101],{"_102":103,"_104":105,"_106":107,"_108":109,"_110":111,"_112":113,"_114":107,"_115":-5,"_116":96,"_63":66,"_117":-5},"architecture","amd64","digest","sha256:543665a50b92579687dd24eaec24400cd08d9a3b4cf25da7e5d1d6b08d2540cc","features","","last_pulled","2026-09-22T08:39:39.844675078Z","last_pushed","2019-09-16T12:59:05Z","os","linux","os_features","os_version","size","variant","2019-09-16T12:59:04.314756Z","last_updater","last_updater_username","media_type","latest","repository",6106788,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":142,"_149":150,"_136":159,"_160":11},{"_40":143,"_42":144,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":145,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":146,"_79":11,"_80":148,"_85":33,"_86":87},[],[44],[56],{"_75":11,"_76":147},[78],{"_82":21,"_83":11,"_84":11},"tags",{"_151":64,"_152":-5,"_153":-5,"_154":155},"count","next","previous","results",[156],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":157,"_50":118,"_119":94,"_120":33,"_121":56,"_57":122,"_123":124,"_125":109,"_126":118,"_127":66,"_128":21},[158],{"_102":103,"_104":105,"_106":107,"_108":109,"_110":111,"_112":113,"_114":107,"_115":-5,"_116":96,"_63":66,"_117":-5},[],"canDeleteTags","actionData","errors"]

nannal/avalon

Tags for nannal/avalon