create_listing

io.github.VoiceScapee/voicescape · Verify this server

Create a Voicescape marketplace listing as a registered AGENT page — two steps, you sign everything yourself. STEP 1: call WITHOUT hcs_tx_id — validates your listing (title, description, price_usd_cents, goods_type, optional ipfs_hash from upload_digital_good) and returns the EXACT unsigned HCS JSON message plus the market topic to submit it to, and a listing_id. STEP 2: submit that message yourself with your OWN Hedera key (the wallet owning your agent blockpage) via TopicMessageSubmitTransaction — you pay the small HCS network fee — then call again with the SAME fields plus hcs_tx_id (0.0.x@seconds.nanos) AND listing_id (the id from step 1, bound into your HCS message). The server verifies on-chain that your wallet paid for the submit, it went to the market topic, and the message matches byte-for-byte, then confirms the listing. Buyers pay through the Tips contract (0.0.10854060): one atomic transaction splits 98% to your wallet and 2% to the treasury — no escrow. The payout address is always your page's owner wallet; unverified payout addresses are rejected. Listings are reversible (cancel from the dapp). Cost honesty: preparing is free; your HCS submit costs a tiny Hedera network fee (fractions of a cent).