Contents


- Setup
- Check draft format
- Wrap draft
- Upload draft
- Look at draft data
- Wrap and upload draft assets
- Look at draft assets data
- Delete draft




Setup


Create a work directory: "new_articles"

Inside the work directory, create these subdirectories:
- "keys"
- "drafts"

Inside the keys directory, create these subdirectories:
- "private_keys"
- "public_keys"

Copy your secondary private key into the "private_keys" directory.

Example private key filename:
stjohn_piano_2_private_key.txt

Explanation: We use a secondary author_name e.g. "stjohn_piano_2" instead of "stjohn_piano". This means that your secondary identity key will be used when signing the wrapped version of the draft. This is for convenience, as usually the secondary key will kept on an online computer (while the primary will be kept on an offline one).

Copy the secondary public key of Edgecase Datafeed into the "public_keys" directory.

Download link:
edgecase_datafeed_2_public_key.txt

Browse to:
github.com/sj-piano/edgecase_article

Check that you have the requirements listed in the README.

Open a shell, and change directory into the work directory.

Clone the edgecase_article repo:


Change to the "edgecase_article" directory.

You'll need to know your Edgecase longUserID, which is stored inside your authentication cookie (and was sent to you in an email when you initially subscribed).

Example longUserID:


In the shell, set your longUserID and authorName:


^ Note: This time, use your primary author name e.g. "stjohn_piano". There's only one author account, although this account can have multiple keys.




Check draft format


Prerequisite: Read How to write an article. This page describes the format of an Edgecase article.

Copy the draft article into "drafts".

Important: Change the author name within the draft to your secondary key name. E.g. change it from "stjohn_piano" to "stjohn_piano_2". This is because in this procedure you will sign the draft with your secondary key. The author name within the draft will be used to look up this public key and verify the signature.

Set a variable containing the draft article file name. Example:


Open a shell and change directory into the work directory.

Check the format:


^ Note: We aren't checking the format of the article file name. It could be called anything e.g. "foo.txt".

Example output:





Wrap draft


Explanation: A "wrapped" file is:
1) Signed by the private key of the sender.
2) Encrypted to the public key of the receiver.
This mechanically guarantees its author in a way that is only visible to the receiver.

Change directory to the work directory.

In the shell, set the wrapped draft file name.


Wrap the draft:





Upload the draft


Upload the wrapped draft:


Example output:



^ Looking at the output, we can see that the title value within the draft has been stripped down into a URI article title. In this case, it is: "blockchain_companies"

Set this value in the shell:





Look at draft data


Test: Get draft metadata.



Example output:




Test: Get draft data:




Look at how the draft gets rendered.
- Browse to edgecase.pro. Need to be logged in.
-- Note: You can log in by visiting this link in the browser:
edgecase.pro/cookies/create/<long_user_id>
- Go to Navigation / Account / Drafts, and click the link to the draft article. (This will be its title.)




Wrap and upload draft assets


Copy the draft assets directory to the "drafts" directory.

In the shell, set a value for the draft assets directory name:


Set some derived values:


Archive the assets directory, and then encode it into base64:



Wrap the result:



Upload draft assets:






Look at draft assets data


Test: Get draft assets metadata:



Example output:



^ We can get the asset name from the output above.

Set this in the shell:



Test: Get draft asset metadata:




Test: Get draft asset data:






Delete the draft


Delete the wrapped draft file:




Delete the wrapped draft asset directory, if it exists:



Delete the draft on Edgecase:
- Note: This will also delete any draft assets.




Example output: