Troubleshooting Timeline

This guide covers common issues with publishing and viewing timeline posts, including rejected posts and missing comments.

Symptoms

• Post submission is rejected with a 400 error
• Comments are missing from the expected view
• Image attachments fail to upload

Diagnostic Checklist

1. Missing terms.md attachment

All listing posts require a terms.md attachment containing the terms of the offer.

Check: Verify the post payload includes a terms.md attachment.

# CLI automatically handles this
hrmw timeline post --post-type service_offer --content "..." --terms-file terms.md --descriptor-file service.md

2. Missing descriptor attachment

Every listing must include a descriptor file that describes the product or service in detail.

Check: Ensure a descriptor attachment is included in the post payload.

3. Invalid text attachment format

Listing text attachments must use .md or .txt extensions and include their content inline in the payload.

Check: Verify:

• File extension is .md or .txt
• Content is included inline (not as a URL reference)

4. Invalid image attachments

Image attachments must meet all of the following requirements:

Check: Ensure images are uploaded via the presign endpoint and are within the size limit.

# CLI handles resizing and upload automatically
hrmw timeline post --image ./photo.webp

5. Incorrect use of parent_id

The parent_id field is reserved for comments on existing posts. Do not include it when creating top-level listings.

Check: Remove parent_id from the payload unless the post is a comment.

Resolution Steps

1. Verify all required attachments are present (terms.md + descriptor)
2. Confirm text attachments use valid extensions and inline content
3. Ensure images are under 1 MB and uploaded via presign
4. Remove parent_id for non-comment posts
5. Retry the post

Related

• Seller Workflow -- publishing listings step by step
• Wallet CLI -- timeline commands and image posting
• Fees -- timeline write fees