Exchange / Operator API Documentation

Recommended V35 node 1.0.18 / wallet 1.0.2 downloads

Recommended versions are Node/server 1.0.18 and wallet/miner 1.0.2. Website/operator guide 1.0.10 contains the current Node 1.0.18 link update. V35 activation is scheduled at block 514291. Before block 514291, v35Active=false is expected and normal.

The public chain height is increasing again after node 1.0.18 / wallet 1.0.2 deployment. Node 1.0.18 adds the bounded V35 public supply reads without full-chain hydration while keeping persisted winner snapshots, live diagnostics, and self-peer protection. This is not a consensus, reward, activation, burn, or jackpot logic change.

java -Xms512m -Xmx1536m -XX:+UseG1GC -XX:MaxGCPauseMillis=500 -XX:+ExitOnOutOfMemoryError -Dlogging.file.path=C:\server\logs -Dlogging.level.root=INFO -Dserver.tomcat.threads.max=80 -Dserver.tomcat.accept-count=100 -Dserver.tomcat.max-connections=1024 -Dserver.port=82 -Dserver.address=194.87.236.238 -Dcitu.prePersistPeerPropagation.enabled=false -Dcitu.memoryForensics.enabled=false -Dcitu.memoryForensics.file.enabled=false -Dcitu.memoryForensics.verbose=false -Dcitu.diagnostic.traces.enabled=false -Dcitu.diagnostic.file.enabled=false -Dcitu.peer.maxPeersPerCycle=3 -Dcitu.peer.maxPeersPerTournamentCycle=3 -Dcitu.peer.maxPeersPerResolveCycle=3 -Dcitu.peer.maxPeersPerPropagationCycle=3 -Dcitu.peer.maxPeersPerReadinessCycle=3 -Dcitu.peer.maxRemoteCallsPerCycle=6 -Dcitu.peer.maxRemoteCallsPerMinute=60 -Dcitu.peer.maxHealthEntries=32 -Dcitu.peer.maxErrorEntries=32 -Dcitu.peer.maxBlockedHostEntries=32 -Dcitu.memoryGuard.skipPeerWorkPercent=70 -Dcitu.memoryGuard.emergencyPeerWorkPercent=85 -Dcitu.peer.connectTimeoutMs=2000 -Dcitu.peer.readTimeoutMs=3000 -Dcitu.resolve.maxDurationMs=5000 -jar C:\citu-node-v35-activation-514291-1.0.18.jar

java -Xms256m -Xmx1024m -XX:+UseG1GC -XX:MaxGCPauseMillis=500 -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=C:\server\logs\citu-wallet-v35-514291.hprof -Dserver.port=8082 -jar C:\citu-wallet-v35-activation-514291-1.0.2.jar

Official repositories and GitHub Releases pages

• Server repository: github.com/CorporateFounder/unitedStates_storage
• Wallet repository: github.com/CorporateFounder/unitedStates_final
• Server GitHub Release: v35-node-activation-514291-1.0.18
• Wallet GitHub Release: v35-wallet-activation-514291-1.0.2

Official JAR names and launch commands

Download ready node and wallet JARs from the official GitHub Releases and verify SHA256 before running.

Node/server JAR: citu-node-v35-activation-514291-1.0.18.jar

Node SHA256: cde4be50c32d137ebcf5b1f9e61ac1a4a6356425d06434fb8c88ebee48b27866

java -Xms512m -Xmx1536m -XX:+UseG1GC -XX:MaxGCPauseMillis=500 -XX:+ExitOnOutOfMemoryError -Dlogging.file.path=C:\server\logs -Dlogging.level.root=INFO -Dserver.tomcat.threads.max=80 -Dserver.tomcat.accept-count=100 -Dserver.tomcat.max-connections=1024 -Dserver.port=82 -Dserver.address=194.87.236.238 -Dcitu.prePersistPeerPropagation.enabled=false -Dcitu.memoryForensics.enabled=false -Dcitu.memoryForensics.file.enabled=false -Dcitu.memoryForensics.verbose=false -Dcitu.diagnostic.traces.enabled=false -Dcitu.diagnostic.file.enabled=false -Dcitu.peer.maxPeersPerCycle=3 -Dcitu.peer.maxPeersPerTournamentCycle=3 -Dcitu.peer.maxPeersPerResolveCycle=3 -Dcitu.peer.maxPeersPerPropagationCycle=3 -Dcitu.peer.maxRemoteCallsPerCycle=6 -Dcitu.peer.maxRemoteCallsPerMinute=60 -Dcitu.peer.connectTimeoutMs=2000 -Dcitu.peer.readTimeoutMs=3000 -Dcitu.resolve.maxDurationMs=5000 -jar C:\citu-node-v35-activation-514291-1.0.18.jar

Wallet JAR: citu-wallet-v35-activation-514291-1.0.2.jar

Wallet SHA256: b2ea4d41925326a8b44115177db17a06ee25e6bfab0e832d7da2153313196179

java -Xms256m -Xmx1024m -XX:+UseG1GC -XX:MaxGCPauseMillis=500 -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=C:\server\logs\citu-wallet-v35-514291.hprof -Dserver.port=8082 -jar C:\citu-wallet-v35-activation-514291-1.0.2.jar

Java must be installed. Confirm with java -version before starting either application.

Important API request and response examples

Examples use public placeholders only. Never put a private key in an exchange integration request.

curl http://localhost:8083/size
506758

curl "http://localhost:8083/balance?address=<PUBLIC_ADDRESS>"
{"digitalDollarBalance":0.01,"digitalStockBalance":0.00}

curl "http://localhost:8083/account?address=<PUBLIC_ADDRESS>"
{"account":"...","digitalDollarBalance":0.01}

curl "http://localhost:8083/customerTransactions?address=<PUBLIC_ADDRESS>&from=0&to=10"
[{"sender":"...","customer":"...","digitalDollar":0.01,"sign":"..."}]

{
  "sender": "...",
  "customer": "...",
  "digitalDollar": 0.01,
  "sign": "..."
}

curl "http://localhost:8083/isTransactionAdd?sign=<BASE58_SIGNATURE>"
true

{"v35Active":false,"v35ForkIndex":514291}

{"burnAddress":"BURN_ADDRESS","isBurnAddressPlaceholder":true,"burnAddressConfigured":false}

{"v35Active":false,"status":"DISABLED"}

Server / node API: backward-compatible legacy surface

These existing routes remain visible for compatibility. Do not rename or remove them during V35 preparation.

Compatibility quick reference: GET /size, GET /prevBlock, POST /statusTransaction58, POST /statusTransaction64, POST /addTransaction.

Server compatibility appendix

Additional discovered legacy routes remain available where deployed:

/keys, /time, /TransactionAddBase, /TransactionAddBase64, /conductorHashTran, /senderCountDto, /customerCountDto, /addresses, /getBlocksBySenderInRange, /findBlocksByCustomerInRange, /putNode, /pool/add, /pool/getPoolBlockMap, /pool/ConfirmedBalances, /pool/getPendingTxMap, /pool/getPoolAddress, /isWait58, /winnerList, /allwinners, /powerWiners, /countTransactionsWiner, /stakingWiners, /bigRandomWiner, /v28Index, /allAccounts, /totalStaking, /totalAll, /totalTransactionsDay, /totalTransactionsSum, /multiplier, /dayReduce, /getNodes, /block, /isSaveFile, /nodes/resolve_from_to_block, /nodes/register, /findAddresses, /difficultyBlockchain, and /timentp.

Wallet API: local legacy compatibility

Wallet endpoints are preserved for local wallet compatibility. They are not recommended as production exchange integration endpoints.

Other discovered local wallet compatibility routes include /TransactionAddBase, /TransactionAddBase64, /blockHash, /findBlocksFromSign58, /findBlocksFromSign64, /conductorBlock, /conductorHashTran, /senderTransactions, /customerTransactions, /senderCountDto, /customerCountDto, /addresses, /TopAddress, /getBlocksBySenderInRange, and /findBlocksByCustomerInRange.

Curl examples

Read height

curl http://localhost:8083/size

Read account

curl "http://localhost:8083/account?address=<PUBLIC_ADDRESS>"

Read received transactions

curl "http://localhost:8083/customerTransactions?address=<PUBLIC_ADDRESS>&from=0&to=10"

Submit reviewed signed JSON

curl -X POST http://localhost:8083/addTransaction ^
  -H "Content-Type: application/json" ^
  --data-binary @reviewed-signed-transaction.json

Check inclusion

curl "http://localhost:8083/isTransactionAdd?sign=<BASE58_SIGNATURE>"

Read V35 protocol

curl http://localhost:8083/v35/protocol

Read V35 burn status

curl http://localhost:8083/v35/burn

Read V35 jackpot status

curl http://localhost:8083/v35/jackpot/status