summaryrefslogtreecommitdiff
path: root/doc/dev
Commit message (Collapse)AuthorAgeFilesLines
...
| * rpc: Speak of "Arti" rather than "arti"Ian Jackson2023-04-031-2/+2
| | | | | | | | | | As per https://gitlab.torproject.org/tpo/core/arti/-/merge_requests/1078#note_2889618
| * rpc: State the integer round-trip range limitsIan Jackson2023-04-031-1/+5
| | | | | | | | | | As per https://gitlab.torproject.org/tpo/core/arti/-/merge_requests/1078#note_2889617
| * rpc: Don't talk about "properties" of objects: rather, "members"Ian Jackson2023-04-031-1/+1
| | | | | | | | | | As per https://gitlab.torproject.org/tpo/core/arti/-/merge_requests/1078#note_2889616
| * rpc: Move notes about cancellation to right sectionIan Jackson2023-04-031-7/+7
| | | | | | | | | | As per https://gitlab.torproject.org/tpo/core/arti/-/merge_requests/1078#note_2889614
| * rpc: Be clearer about updates contentIan Jackson2023-04-031-2/+3
| | | | | | | | | | | | | | | | You can't parse an update without knowing the request method (this was already stated elsewhere). Prompted by https://gitlab.torproject.org/tpo/core/arti/-/merge_requests/1078#note_2889613
| * rpc: Change how we talk about objectsIan Jackson2023-04-031-1/+6
| | | | | | | | | | | | | | | | | | Use just "object" in the introduction, but be specific that the abstract data type is I-JSON, even if we later invent other representations. Prompted by https://gitlab.torproject.org/tpo/core/arti/-/merge_requests/1078#note_2889612
| * rpc: Right at top, say I-JSONIan Jackson2023-04-031-1/+1
| | | | | | | | | | Prompted by https://gitlab.torproject.org/tpo/core/arti/-/merge_requests/1078#note_2889612
| * rpc: Change wording about responsesIan Jackson2023-04-031-1/+1
| | | | | | | | | | Prompted by https://gitlab.torproject.org/tpo/core/arti/-/merge_requests/1078#note_2889611
| * rpc: Start on a list of the differences with JSON-RPCIan Jackson2023-03-241-0/+23
| |
| * rpc: Discuss ordering and bufferingIan Jackson2023-03-241-0/+13
| |
| * rpc: Define term `field`Ian Jackson2023-03-241-0/+2
| |
| * rpc: Discuss cancellation request objIan Jackson2023-03-241-0/+9
| |
| * rpc: Clarify what precisely the responses depend onIan Jackson2023-03-241-2/+4
| | | | | | | | | | | | | | | | The format of an update or result depends on the *method* but not the parameters or the subject. Declare that the format of an error is uniform. (It could have an enum in it.)
| * rpc: State that we're using I-JSONIan Jackson2023-03-241-0/+8
| |
| * rpc: Forbid troublesome numbers as idsIan Jackson2023-03-241-2/+4
| | | | | | | | | | This is a bit sad but I think we should have a conservative JSON profile.
| * rpc: Be more explicit about ignoring JSON fieldsIan Jackson2023-03-241-1/+4
| |
| * rpc: Clarify/restate method definition requirementsIan Jackson2023-03-241-9/+10
| | | | | | | | | | | | | | In particular, abolish the notion of a "response type". Since responses don't come with a discriminant, each method may have only one success response format (although of course that format might itself have optional fields or be an enum or something).
| * rpc: Use Object for method targets and JSON object for document objectsIan Jackson2023-03-241-29/+31
| |
| * rpc: Make `params` in a request non-optionalIan Jackson2023-03-241-1/+5
| | | | | | | | | | | | *If* it is optional that would depend on the request, which is a bit complicated to specify precisely. And making it mandatory is more orthogonal.
* | Fix typoDimitris Apostolou2023-03-241-1/+1
|/
* rpc-meta-draft: Sketch an even-lower-level API.Nick Mathewson2023-03-241-0/+11
|
* rpc-draft: Sketch out more commands to add, start sketching APIsNick Mathewson2023-03-241-1/+112
|
* rpc-meta: clarify when "object" means "JSON object".Nick Mathewson2023-03-241-8/+7
|
* rpc-meta: expand on handle/reference semantics.Nick Mathewson2023-03-241-5/+24
|
* rpc-meta: Use "will" for what Arti does, "must" for what client does.Nick Mathewson2023-03-241-4/+4
|
* rpc-meta: Rename intermediate response to "update".Nick Mathewson2023-03-241-25/+23
|
* rpc-meta-draft: consistently say "request" or "method", not "command".Nick Mathewson2023-03-241-15/+15
|
* rpc-meta-draft: make a number of localized changes from the review.Nick Mathewson2023-03-241-21/+103
|
* Start drafting a dev note about a JSON-based OO RPC design.Nick Mathewson2023-03-241-0/+348
|
* Rename key identifiers that have changed in the specNick Mathewson2023-02-081-1/+1
| | | | | | | | | Generated with perl: s/K([PS])_hs_intro_tid/K$1_hs_ipt_sid/g; s/K([PS])_onion_ntor/K$1_ntor/g; s/K([PS])_hs_intro_ntor/K$1_hss_ntor/g; s/K([PS])_hs_desc_ephem/K$1_hss_desc_enc/g;
* Update Tor number for s101 o3 (Tor: 2033cc7b5e).Alexander Færøy2023-01-271-0/+13
|
* Fix typo.Alexander Færøy2023-01-271-1/+1
|
* exportedapisketc: note that HTTP can be tricky.Nick Mathewson2023-01-261-0/+12
|
* Merge branch 'netdoc-builder' into 'main'eta2023-01-261-177/+1
|\ | | | | | | | | tor-netdoc: Provide NetdocEncoder (internal) See merge request tpo/core/arti!984
| * netdoc-builder: Move example into implementation doc commentIan Jackson2023-01-241-18/+0
| | | | | | | | Not actually tested yet
| * netdoc-builder api: Move internal API into actual code fileIan Jackson2023-01-241-135/+1
| | | | | | | | Motion, plus the bare minimum needed to make it compile.
| * netdoc-builder api: Remove obsolete proposed `Item` changesIan Jackson2023-01-241-24/+0
| | | | | | | | We decided against these in !969
* | New results for heap_and_download_size.mdNick Mathewson2023-01-251-0/+13
| |
* | Try to be less ambigous about "maybe offline"...Nick Mathewson2023-01-241-9/+15
| | | | | | | | | | | | ...by defining "offline" as "maybe online". @diziet is this what you had in mind?
* | Try to specify which keys are whichNick Mathewson2023-01-241-13/+20
| | | | | | | | Use the terminology in the current draft torspec!105 MR.
* | Add a note about key storage in onion services and clientsNick Mathewson2023-01-241-0/+99
|/
* netdoc-builder api: Write down the correctness (non)-guaranteesIan Jackson2023-01-201-0/+10
|
* netdoc-builder api: Make object() take selfIan Jackson2023-01-201-3/+3
| | | | | As per https://gitlab.torproject.org/tpo/core/arti/-/merge_requests/969#note_2869594
* netdoc-builder api: Change object multiplicity to 0 or 1Ian Jackson2023-01-201-5/+5
|
* netdoc-builder api: Provide raw methodsIan Jackson2023-01-201-0/+27
|
* netdoc-builder api: Fix typoIan Jackson2023-01-201-1/+1
|
* netdoc-builder api: Clarify ItemEncoder.objects contentIan Jackson2023-01-201-0/+4
|
* netdoc-builder api: In internal notes don't promise not to eagerly addIan Jackson2023-01-201-1/+2
|
* netdoc-builder api: Rename internal Builder to EncoderIan Jackson2023-01-201-15/+16
| | | | | This seems clearer now and also it solves the name clash with the `NetdocBuilder` trait.
* netdoc-builder api: Get rid of Item, and error reworkIan Jackson2023-01-201-6/+45
|