Skip to content

Commit bfea9e0

Browse files
authored
Simplify documentation
1 parent b14dd5b commit bfea9e0

1 file changed

Lines changed: 10 additions & 184 deletions

File tree

README.md

Lines changed: 10 additions & 184 deletions
Original file line numberDiff line numberDiff line change
@@ -131,37 +131,24 @@ cd java-tron
131131

132132
* Build in [IntelliJ IDEA](https://www.jetbrains.com/idea/) (community version is enough):
133133

134+
** Please run ./gradlew build once to build the protocol files **
135+
134136
1. Start IntelliJ. Select `File` -> `Open`, then locate to the java-tron folder which you have git cloned to your local drive. Then click `Open` button on the right bottom.
135137
2. Check on `Use auto-import` on the `Import Project from Gradle` dialog. Select JDK 1.8 in the `Gradle JVM` option. Then click `OK`.
136138
3. IntelliJ will open the project and start gradle syncing, which will take several minutes, depending on your network connection and your IntelliJ configuration
137-
4. After the syncing finished, select `Gradle` -> `Tasks` -> `build`, and then double click `build` option.
138-
139+
4. Enable Annotations, `Preferences` -> Search `annotations` -> check `Enable Annotation Processing`.
140+
5. After the syncing finished, select `Gradle` -> `Tasks` -> `build`, and then double click `build` option.
141+
139142
# Running
140143

141-
## Running a Private Testnet
142-
143-
### How to run a full node
144-
145-
* You should modify the config.conf
146-
1. Replace existing entry in genesis.block.witnesses with your address.
147-
2. Replace existing entry in seed.node ip.list with your ip list.
148-
149-
* In the Terminal
150-
151-
```bash
152-
./gradlew run
153-
```
144+
### Running multi-nodes
154145

155-
* Use the executable JAR
146+
https://github.com/tronprotocol/Documentation/blob/master/TRX/Solidity_and_Full_Node_Deployment_EN.md
156147

157-
```bash
158-
cd build/libs
159-
java -jar java-tron.jar
160-
```
148+
## Running a local node and connecting to the public testnet
161149

162-
* In IntelliJ IDEA
163-
1. After the building finishes, locate `FullNode` in the project structure view panel, which is on the path `java-tron/src/main/java/org.tron/program/FullNode`.
164-
2. Select `FullNode`, right click on it, and select `Run 'FullNode.main()'`, then `FullNode` starts running.
150+
* Ensure that the version number is consistent with the version number of the test network. If it is not consistent, please modify the node.p2p.version in the config.conf file and delete the out-directory directory (if it exists).
151+
* The current p2p.version is **619**
165152

166153
### How to run a Super Node
167154
* use master branch
@@ -304,45 +291,6 @@ In the `Program arguments` option, fill in `--witness`:
304291
305292
Then, run `FullNode::main()` again.
306293
307-
### Running multi-nodes
308-
309-
To run TRON on more than one node, you need to specify several seed nodes' IPs in `config.conf` in `seed.node.ip.list`:
310-
For private test net, the IPs are allocated by yourself.
311-
312-
## Running a local node and connecting to the public testnet
313-
314-
* Ensure that the version number is consistent with the version number of the test network. If it is not consistent, please modify the node.p2p.version in the config.conf file and delete the out-directory directory (if it exists).
315-
* The current p2p.version is **61**
316-
317-
### Running a Full Node
318-
319-
* In the Terminal
320-
321-
```bash
322-
./gradlew run
323-
```
324-
325-
* Use the executable JAR
326-
327-
```bash
328-
cd build/libs
329-
java -jar java-tron.jar
330-
```
331-
332-
### Running a Solidity Node
333-
334-
* Use the executable JAR
335-
336-
```bash
337-
cp src/main/resources/config.conf build/libs
338-
cd build/libs
339-
340-
edit the file config.conf
341-
modify the 'trustNode', it should be a pair of ip and rpc port of a full node
342-
343-
java -jar SolidityNode.jar -c config.conf
344-
```
345-
346294
### Running a Super Node
347295
348296
* Use the executable JAR(Recommended way)
@@ -380,128 +328,6 @@ This is similar to running a private testnet, except that the IPs in the `config
380328
20:43:20.569 INFO [main] [o.t.c.c.TransactionCapsule](TransactionCapsule.java:83) Transaction create succeeded!
381329
20:43:20.596 INFO [main] [o.t.c.d.Manager](Manager.java:300) create genesis block
382330
20:43:20.607 INFO [main] [o.t.c.d.Manager](Manager.java:306) save block: BlockCapsule
383-
[ hash=00000000000000007b7a4241e41e57a9d4ca98217af86b8f3f6ac93f2bf11716
384-
number=0
385-
parentId=0000000000000000000000000000000000000000000000000000000000000000
386-
witness address=
387-
generated by myself=true
388-
generate time=1970-01-01 08:00:00.0
389-
merkle root=b5d2071118f2a33ac0ec377d947aabb4a8a3ddbe36d1a01cdbc38f58863de7c0
390-
txs size=5
391-
tx: {0:TransactionCapsule
392-
[ hash=33d5385f666b0411a2e5829f57d26d7bf0a80b92865f732bd918a2b821bd14be
393-
contract list:{ [0] type: TransferContract
394-
from address=[B@7fe7c640
395-
to address=[B@4c4748bf
396-
transfer amount=10000000000000000
397-
}
398-
]
399-
1:TransactionCapsule
400-
[ hash=df936c9c026ee969781db8a20a2644c7b29688199a342047ce96b4d8bc79b32c
401-
contract list:{ [0] type: TransferContract
402-
from address=[B@7ce97ee5
403-
to address=[B@32c8e539
404-
transfer amount=15000000000000000
405-
}
406-
]
407-
2:TransactionCapsule
408-
[ hash=96d505f8496585dab8e8300dfead6f395ab94f150861ffec3679314e257a0888
409-
contract list:{ [0] type: TransferContract
410-
from address=[B@73dce0e6
411-
to address=[B@5a85c92
412-
transfer amount=10000000000000000
413-
}
414-
]
415-
3:TransactionCapsule
416-
[ hash=950fece7e1a1a70cac971b68c3aadbd14163465aa079bf4d51d1ce5820d7f02d
417-
contract list:{ [0] type: TransferContract
418-
from address=[B@32811494
419-
to address=[B@4795ded0
420-
transfer amount=-9223372036854775808
421-
}
422-
]
423-
4:TransactionCapsule
424-
[ hash=43dbd16a80393835f2bda8c71dc8ede389900425f3a328c16366c63a975ddb26
425-
contract list:{ [0] type: TransferContract
426-
from address=[B@2eced48b
427-
to address=[B@47c4ecdc
428-
transfer amount=15000000000000000
429-
}
430-
]
431-
}]
432-
20:43:20.607 INFO [main] [o.t.c.d.DynamicPropertiesStore](DynamicPropertiesStore.java:252) update latest block header number = 0
433-
20:43:20.609 INFO [main] [o.t.c.d.DynamicPropertiesStore](DynamicPropertiesStore.java:260) update latest block header id = 00000000000000007b7a4241e41e57a9d4ca98217af86b8f3f6ac93f2bf11716
434-
20:43:20.609 INFO [main] [o.t.c.d.DynamicPropertiesStore](DynamicPropertiesStore.java:244) update latest block header timestamp = 0
435-
20:43:20.631 INFO [main] [o.t.c.w.WitnessController](WitnessController.java:64) initWits shuffled addresses:a055ddae14564f82d5b94c7a131b5fcfd31ad6515a
436-
20:43:20.814 INFO [main] [o.t.c.c.a.Args](Args.java:415) New nodeID generated: d5294e129edcb5c648af927bf9b66d61ae11b356dca0b193d85a7c8771b0e8b211e603e3608542bf521456ff1371ad7a2400b6126bc0b1f872af7f479c55afe9
437-
20:43:20.815 INFO [main] [o.t.c.c.a.Args](Args.java:416) Generated nodeID and its private key stored in output-directory/database/nodeId.properties
438-
20:43:20.861 INFO [main] [NodeManager](NodeManager.java:96) homeNode : Node{ host='47.74.147.87', port=18888, id=d5294e129edcb5c648af927bf9b66d61ae11b356dca0b193d85a7c8771b0e8b211e603e3608542bf521456ff1371ad7a2400b6126bc0b1f872af7f479c55afe9}
439-
20:43:20.861 INFO [main] [NodeManager](NodeManager.java:97) bootNodes : size= 11
440-
20:43:21.054 INFO [PeerServerThread] [PeerServer](PeerServer.java:86) TCP listener started, bind port 18888
441-
20:43:21.073 INFO [main] [o.t.p.FullNode](FullNode.java:47) ******** application shutdown ********
442-
20:43:21.090 WARN [main] [o.t.c.s.WitnessService](WitnessService.java:268) WitnessCapsule[[B@620aa4ea] is not in witnessStore
443-
20:43:21.146 WARN [PeerServerThread] [i.n.b.ServerBootstrap](Slf4JLogger.java:146) Unknown channel option 'SO_KEEPALIVE' for channel '[id: 0xfbdea61d]'
444-
20:43:21.182 INFO [UDPListener] [UDPListener](UDPListener.java:104) Discovery UDPListener started, bind port 18888
445-
20:43:21.183 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:159) Reading Node statistics from PeersStore: 0 nodes.
446-
20:43:21.227 INFO [main] [o.t.c.s.RpcApiService](RpcApiService.java:100) Server started, listening on 50051
447-
20:43:21.233 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 47.254.16.55:18888, id=791191e1], size=1
448-
20:43:21.234 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 47.254.18.49:18888, id=e82c773d], size=2
449-
20:43:21.234 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 18.188.111.53:18888, id=96db4efd], size=3
450-
20:43:21.235 INFO [main] [o.t.c.n.n.NodeImpl](NodeImpl.java:595) other peer is nil, please wait ...
451-
20:43:21.235 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 54.219.41.56:18888, id=a9f6b900], size=4
452-
20:43:21.235 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 35.169.113.187:18888, id=80c10f5e], size=5
453-
20:43:21.236 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 34.214.241.188:18888, id=df0b9f01], size=6
454-
20:43:21.236 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 47.254.146.147:18888, id=976440e3], size=7
455-
20:43:21.237 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 47.254.144.25:18888, id=e22a29e9], size=8
456-
20:43:21.238 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 47.91.246.252:18888, id=c1dbf350], size=9
457-
20:43:21.241 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 47.91.216.69:18888, id=07cc3858], size=10
458-
20:43:21.241 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 39.106.220.120:18888, id=e9c9ffda], size=11
459-
20:43:21.278 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:202) Change node: old NodeHandler[state: Discovered, node: 39.106.220.120:18888, id=e9c9ffda] new Node{ host='39.106.220.120', port=18888, id=ffaba569088f7497e60c5d4b9a9c110151f09be6e17e448e92086cb8336e1602aa42abd59a6dd0fdbdcfd78bb9360e3574866ae5a624dd8445d4906f0245c75d}, size =11
460-
20:43:21.285 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:202) Change node: old NodeHandler[state: Discovered, node: 47.91.246.252:18888, id=c1dbf350] new Node{ host='47.91.246.252', port=18888, id=aed3688f52718c895d3181eb8223f6556f0689f6515862fb08e70200b5970aae7f6c97fc304946630db595c3f9d75a5e056496045e536dc55a1a143ccc49925d}, size =11
461-
20:43:21.287 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:202) Change node: old NodeHandler[state: Discovered, node: 47.91.216.69:18888, id=07cc3858] new Node{ host='47.91.216.69', port=18888, id=b45aa0d92931e47cb6a3d3ef5f8fd3ba88c74413d7ea539175d1466bff875900e15390a52599b504830d6cb7e7e2d9c68412e23434dbced7b13230914af2276e}, size =11
462-
20:43:21.435 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:202) Change node: old NodeHandler[state: Discovered, node: 47.254.16.55:18888, id=791191e1] new Node{ host='47.254.16.55', port=18888, id=1a70d710248c6832b5bce762bd8dd09e0bb401a3e57c360db7d502c6e80b023226f0540635a72c6f1589d134568d4dc2fe1e9ff49a66601d924d28fdc12303a9}, size =11
463-
20:43:21.445 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:202) Change node: old NodeHandler[state: Discovered, node: 47.254.18.49:18888, id=e82c773d] new Node{ host='47.254.18.49', port=18888, id=28da8efcc5f2d7c7ddc74487b99ef232fe4a97c2eb6b8bcc32edc97d1d4ef357eb8d2347e824ff898fe7936efae70f0b29861dec8c22923a40998230cf1db08f}, size =11
464-
20:43:21.454 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:202) Change node: old NodeHandler[state: Discovered, node: 34.214.241.188:18888, id=df0b9f01] new Node{ host='34.214.241.188', port=18888, id=7380f11f7b1ed4a715c41131ffb66234cef21d83973aef89f75d3cea7036b221dea1acbf580e8df4a315845faf25e94d3ffc3c02507f687931ebac9725f59961}, size =11
465-
20:43:21.480 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:202) Change node: old NodeHandler[state: Discovered, node: 18.188.111.53:18888, id=96db4efd] new Node{ host='18.188.111.53', port=18888, id=23de133437c136b856b2a6906ff21fb6fe74736efc0496a8f7850460a9a600ee6f02d79d7ca15954f69b36411e36e96ec70c5a1c0d4891db0ffb70db19503a23}, size =11
466-
20:43:21.503 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:202) Change node: old NodeHandler[state: Discovered, node: 35.169.113.187:18888, id=80c10f5e] new Node{ host='35.169.113.187', port=18888, id=156dc977b34fa77a1377e5c4f9e2862f34b2c5309f9d86220b5dd4200383f4fb1859c3de90a8acecf9d91edff697a8f0a59346a239e3d5e269aed0b0186c8bc5}, size =11
467-
20:43:21.533 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:202) Change node: old NodeHandler[state: Discovered, node: 47.254.144.25:18888, id=e22a29e9] new Node{ host='47.254.144.25', port=18888, id=273eb89021d9741f0ff47c99c4e03d88776606acf39c970d7549512baf8444166883016e3c0859f7df3042fcfebf52b0af3d6cb216145b677eba10c6161c0cbc}, size =11
468-
20:43:21.543 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:202) Change node: old NodeHandler[state: Discovered, node: 47.254.146.147:18888, id=976440e3] new Node{ host='47.254.146.147', port=18888, id=1868f20b346420dcc1826551cc1427df36313f21fb077ba714210beb270b05a865516d53a734ccdd00468e23d21f1beef6c12299e7a4eda40408bf242ba6a2f8}, size =11
469-
20:43:21.729 INFO [Thread-5] [o.t.c.s.WitnessService](WitnessService.java:141) Try Produce Block
470-
20:43:21.792 INFO [Thread-5] [o.t.c.s.WitnessService](WitnessService.java:107) Not sync
471-
20:43:22.047 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 119.61.19.34:10846, id=d456c5af], size=12
472-
20:43:22.048 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 223.71.166.85:10846, id=d456c5af], size=13
473-
20:43:22.048 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 223.71.166.85:23018, id=d456c5af], size=14
474-
20:43:22.049 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 139.162.177.66:18888, id=d689b030], size=15
475-
20:43:22.049 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 168.235.68.117:18888, id=d04f7fa0], size=16
476-
20:43:22.049 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 185.101.157.48:18888, id=d00a272a], size=17
477-
20:43:22.050 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 89.201.166.70:18888, id=d2af1da8], size=18
478-
20:43:22.050 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 119.27.171.102:18888, id=c2dbea82], size=19
479-
20:43:22.051 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 35.197.108.225:18888, id=cb71adfc], size=20
480-
20:43:22.051 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 128.1.44.16:18888, id=c042b706], size=21
481-
20:43:22.052 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 119.61.19.34:43966, id=c6efd4d7], size=22
482-
20:43:22.053 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 223.71.166.85:43966, id=c6efd4d7], size=23
483-
20:43:22.053 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 223.71.166.85:48162, id=c1958356], size=24
484-
20:43:22.054 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 127.0.0.1:18888, id=ffaba569], size=25
485-
20:43:22.054 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 114.247.223.59:65036, id=fb716ca2], size=26
486-
20:43:22.169 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 119.61.19.34:15869, id=d80bda91], size=27
487-
20:43:22.169 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 83.87.113.32:18888, id=f093814a], size=28
488-
20:43:22.170 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 217.198.124.133:18888, id=e3c811ee], size=29
489-
20:43:22.170 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 142.227.120.102:18888, id=f49bc300], size=30
490-
20:43:22.171 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 223.71.166.85:34900, id=932a6b9d], size=31
491-
20:43:22.266 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 54.95.77.190:18888, id=d07f46e2], size=32
492-
20:43:22.266 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 23.239.19.106:18888, id=d3753c48], size=33
493-
20:43:22.267 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 223.71.166.85:42096, id=d92bec47], size=34
494-
20:43:22.267 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 173.14.84.113:26307, id=d95e9fe1], size=35
495-
20:43:22.267 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 195.224.160.13:54631, id=d9a14e17], size=36
496-
20:43:22.268 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 114.247.223.59:43160, id=dc87d741], size=37
497-
20:43:22.268 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 119.61.19.34:42096, id=d92bec47], size=38
498-
20:43:22.268 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 68.101.240.4:1024, id=dbb7c4a1], size=39
499-
20:43:22.269 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 47.93.9.236:18888, id=d850df83], size=40
500-
20:43:22.269 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 119.61.19.34:15837, id=d80bda91], size=41
501-
20:43:22.269 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 31.146.78.129:1024, id=c2b1d172], size=42
502-
20:43:22.270 INFO [nioEventLoopGroup-2-1] [NodeManager](NodeManager.java:200) Add new node: NodeHandler[state: Discovered, node: 95.137.168.179:28228, id=c2b1d172], size=43
503-
20:43:22.295 INFO [Thread-5] [o.t.c.s.WitnessService](WitnessService.java:141) Try Produce Block
504-
20:43:22.296 INFO [Thread-5] [o.t.c.s.WitnessService](WitnessService.java:107) Not sync
505331
506332
```
507333

0 commit comments

Comments
 (0)