@minca/core 0.1.9 → 0.1.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/dist/identity/abilities.d.ts +3 -3
- package/dist/identity/abilities.d.ts.map +1 -1
- package/dist/identity/abilities.js +9 -11
- package/dist/identity/abilities.js.map +1 -1
- package/dist/identity/contact-key.d.ts +15 -15
- package/dist/identity/contact-key.d.ts.map +1 -1
- package/dist/identity/contact-key.js +21 -28
- package/dist/identity/contact-key.js.map +1 -1
- package/dist/identity/root-signer.d.ts +0 -5
- package/dist/identity/root-signer.d.ts.map +1 -1
- package/dist/identity/root-signer.js +0 -1
- package/dist/identity/root-signer.js.map +1 -1
- package/dist/inbox/inbox.d.ts +140 -0
- package/dist/inbox/inbox.d.ts.map +1 -0
- package/dist/inbox/inbox.js +212 -0
- package/dist/inbox/inbox.js.map +1 -0
- package/dist/inbox/index.d.ts +9 -0
- package/dist/inbox/index.d.ts.map +1 -0
- package/dist/inbox/index.js +7 -0
- package/dist/inbox/index.js.map +1 -0
- package/dist/index.d.ts +3 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/network/mailbox.d.ts +4 -4
- package/dist/network/mailbox.d.ts.map +1 -1
- package/dist/network/mailbox.js +5 -5
- package/dist/network/mailbox.js.map +1 -1
- package/dist/node/actions.d.ts.map +1 -1
- package/dist/node/actions.js +28 -18
- package/dist/node/actions.js.map +1 -1
- package/dist/node/api.d.ts +11 -10
- package/dist/node/api.d.ts.map +1 -1
- package/dist/node/api.js +11 -10
- package/dist/node/api.js.map +1 -1
- package/dist/node/carrier.d.ts +11 -5
- package/dist/node/carrier.d.ts.map +1 -1
- package/dist/node/carrier.js +42 -1
- package/dist/node/carrier.js.map +1 -1
- package/dist/node/copy.d.ts +1 -1
- package/dist/node/copy.d.ts.map +1 -1
- package/dist/node/copy.js +10 -4
- package/dist/node/copy.js.map +1 -1
- package/dist/node/host.d.ts +2 -0
- package/dist/node/host.d.ts.map +1 -1
- package/dist/node/host.js +2 -0
- package/dist/node/host.js.map +1 -1
- package/dist/node/index.d.ts +1 -1
- package/dist/node/index.d.ts.map +1 -1
- package/dist/node/node.d.ts.map +1 -1
- package/dist/node/node.js +720 -542
- package/dist/node/node.js.map +1 -1
- package/dist/node/remote.d.ts +6 -5
- package/dist/node/remote.d.ts.map +1 -1
- package/dist/node/remote.js +140 -195
- package/dist/node/remote.js.map +1 -1
- package/dist/node/space-runtime.d.ts +2 -1
- package/dist/node/space-runtime.d.ts.map +1 -1
- package/dist/node/space-runtime.js +71 -84
- package/dist/node/space-runtime.js.map +1 -1
- package/dist/node/types.d.ts +84 -47
- package/dist/node/types.d.ts.map +1 -1
- package/dist/node/worker.d.ts +1 -1
- package/dist/node/worker.d.ts.map +1 -1
- package/dist/node/worker.js +10 -6
- package/dist/node/worker.js.map +1 -1
- package/dist/react/use-invite-link.d.ts +1 -1
- package/dist/react/use-invite-link.d.ts.map +1 -1
- package/dist/react/use-invite-link.js +18 -11
- package/dist/react/use-invite-link.js.map +1 -1
- package/dist/records/loose.d.ts +52 -0
- package/dist/records/loose.d.ts.map +1 -0
- package/dist/records/loose.js +86 -0
- package/dist/records/loose.js.map +1 -0
- package/dist/schema/version.d.ts +2 -0
- package/dist/schema/version.d.ts.map +1 -1
- package/dist/schema/version.js +2 -1
- package/dist/schema/version.js.map +1 -1
- package/dist/schemas/choosing.d.ts +19 -0
- package/dist/schemas/choosing.d.ts.map +1 -0
- package/dist/schemas/choosing.js +69 -0
- package/dist/schemas/choosing.js.map +1 -0
- package/dist/schemas/contacts.d.ts +34 -87
- package/dist/schemas/contacts.d.ts.map +1 -1
- package/dist/schemas/contacts.js +32 -76
- package/dist/schemas/contacts.js.map +1 -1
- package/dist/schemas/index.d.ts +2 -2
- package/dist/schemas/index.d.ts.map +1 -1
- package/dist/schemas/index.js +1 -1
- package/dist/schemas/index.js.map +1 -1
- package/dist/schemas/library/annotations.d.ts +17 -285
- package/dist/schemas/library/annotations.d.ts.map +1 -1
- package/dist/schemas/library/annotations.js +9 -65
- package/dist/schemas/library/annotations.js.map +1 -1
- package/dist/schemas/library/community.d.ts +9 -17
- package/dist/schemas/library/community.d.ts.map +1 -1
- package/dist/schemas/library/community.js +5 -5
- package/dist/schemas/library/community.js.map +1 -1
- package/dist/schemas/library/life.d.ts +3 -3
- package/dist/schemas/library/life.d.ts.map +1 -1
- package/dist/schemas/library/life.js +2 -2
- package/dist/schemas/library/life.js.map +1 -1
- package/dist/schemas/library/media.d.ts +148 -541
- package/dist/schemas/library/media.d.ts.map +1 -1
- package/dist/schemas/library/media.js +28 -64
- package/dist/schemas/library/media.js.map +1 -1
- package/dist/schemas/library/money.d.ts +8 -8
- package/dist/schemas/library/money.d.ts.map +1 -1
- package/dist/schemas/library/money.js +4 -4
- package/dist/schemas/library/money.js.map +1 -1
- package/dist/schemas/library/planning.d.ts +23 -87
- package/dist/schemas/library/planning.d.ts.map +1 -1
- package/dist/schemas/library/planning.js +10 -26
- package/dist/schemas/library/planning.js.map +1 -1
- package/dist/schemas/library/publishing.d.ts +14 -14
- package/dist/schemas/library/publishing.d.ts.map +1 -1
- package/dist/schemas/library/publishing.js +7 -7
- package/dist/schemas/library/publishing.js.map +1 -1
- package/dist/schemas/library/social.d.ts +2 -2
- package/dist/schemas/library/social.d.ts.map +1 -1
- package/dist/schemas/library/social.js +1 -1
- package/dist/schemas/library/social.js.map +1 -1
- package/dist/schemas/standard.d.ts +1 -1
- package/dist/schemas/standard.d.ts.map +1 -1
- package/dist/schemas/standard.js +3 -3
- package/dist/schemas/standard.js.map +1 -1
- package/dist/session/auth.d.ts +20 -0
- package/dist/session/auth.d.ts.map +1 -1
- package/dist/session/auth.js +81 -64
- package/dist/session/auth.js.map +1 -1
- package/dist/session/connect.d.ts +50 -8
- package/dist/session/connect.d.ts.map +1 -1
- package/dist/session/connect.js +91 -27
- package/dist/session/connect.js.map +1 -1
- package/dist/session/connection.d.ts +39 -6
- package/dist/session/connection.d.ts.map +1 -1
- package/dist/session/connection.js +107 -38
- package/dist/session/connection.js.map +1 -1
- package/dist/session/hosting.d.ts +15 -0
- package/dist/session/hosting.d.ts.map +1 -1
- package/dist/session/hosting.js +55 -4
- package/dist/session/hosting.js.map +1 -1
- package/dist/session/index.d.ts +5 -5
- package/dist/session/index.d.ts.map +1 -1
- package/dist/session/index.js +2 -2
- package/dist/session/index.js.map +1 -1
- package/dist/space/account-registry.d.ts +36 -4
- package/dist/space/account-registry.d.ts.map +1 -1
- package/dist/space/account-registry.js +30 -3
- package/dist/space/account-registry.js.map +1 -1
- package/dist/space/invitation.d.ts +61 -0
- package/dist/space/invitation.d.ts.map +1 -0
- package/dist/space/invitation.js +84 -0
- package/dist/space/invitation.js.map +1 -0
- package/dist/space/invite-link.d.ts +64 -0
- package/dist/space/invite-link.d.ts.map +1 -0
- package/dist/space/invite-link.js +212 -0
- package/dist/space/invite-link.js.map +1 -0
- package/dist/space/roles.d.ts +59 -140
- package/dist/space/roles.d.ts.map +1 -1
- package/dist/space/roles.js +328 -427
- package/dist/space/roles.js.map +1 -1
- package/dist/space/space-manager.d.ts +21 -6
- package/dist/space/space-manager.d.ts.map +1 -1
- package/dist/space/space-manager.js +40 -23
- package/dist/space/space-manager.js.map +1 -1
- package/dist/types.d.ts +2 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js.map +1 -1
- package/docs/README.md +2 -2
- package/docs/actions.md +40 -40
- package/docs/agents.md +2 -2
- package/docs/automations.md +2 -2
- package/docs/blueprints-and-guides.md +61 -1
- package/docs/bots.md +1 -1
- package/docs/building-an-app.md +2 -2
- package/docs/contacts.md +48 -69
- package/docs/inbox.md +145 -0
- package/docs/node.md +135 -76
- package/docs/query-format.md +1 -1
- package/docs/sign-in.md +16 -9
- package/docs/spaces.md +33 -5
- package/docs/standard-library.md +111 -86
- package/docs/storage.md +1 -1
- package/package.json +5 -5
- package/dist/doors/doors.d.ts +0 -140
- package/dist/doors/doors.d.ts.map +0 -1
- package/dist/doors/doors.js +0 -226
- package/dist/doors/doors.js.map +0 -1
- package/dist/doors/index.d.ts +0 -9
- package/dist/doors/index.d.ts.map +0 -1
- package/dist/doors/index.js +0 -7
- package/dist/doors/index.js.map +0 -1
- package/docs/doors.md +0 -151
package/dist/doors/doors.d.ts
DELETED
|
@@ -1,140 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @module doors
|
|
3
|
-
* Doors: how someone you share no space with can ask to become your contact.
|
|
4
|
-
*
|
|
5
|
-
* A DID is a name, not an address — knowing it must not be enough to reach
|
|
6
|
-
* you. A **door** is an address you hand out on purpose, and can close:
|
|
7
|
-
*
|
|
8
|
-
* - a **door key**, derived from your contact key and the door's id
|
|
9
|
-
* (`deriveDoorKeyBytes`), which says nothing about the account behind it,
|
|
10
|
-
* and a **signing key** beside it (`deriveDoorSignKeyBytes`) that proves
|
|
11
|
-
* ownership of the door — to a relay clearing its mailbox, and to a knocker
|
|
12
|
-
* when you answer;
|
|
13
|
-
* - the **relays** whose mailboxes hold knocks on it — two or three, chosen by
|
|
14
|
-
* you, so no one relay can shut it.
|
|
15
|
-
*
|
|
16
|
-
* Both travel in a **door code** (a link, a QR code, a line in a bio). Someone
|
|
17
|
-
* with it **knocks**: makes a private space for the two of you, and leaves its
|
|
18
|
-
* invite, sealed to the door key, in the door's mailboxes. The knock is signed
|
|
19
|
-
* by the knocker's session key under their account's note, like a record, so
|
|
20
|
-
* it proves who knocked before anyone joins anything. Opening the door is
|
|
21
|
-
* joining that space.
|
|
22
|
-
*
|
|
23
|
-
* ```
|
|
24
|
-
* code = base64url(JSON { v: 1, key, sign, relays, name? })
|
|
25
|
-
* topic = base64url(SHA-256("minca/door-topic/v1|" + sign))
|
|
26
|
-
* knock = sealTo(key, "minca/knock/v1", { door: key }, JSON { body, sig }) // HPKE
|
|
27
|
-
* body = { v: 2, door: key, from, name, invite, note?, at, session, proof }
|
|
28
|
-
* sig = session key signs canonical(body)
|
|
29
|
-
* ```
|
|
30
|
-
*
|
|
31
|
-
* The relay sees a topic and a sealed blob: not whose door it is, not who
|
|
32
|
-
* knocked, not what they said. See `spec/07-doors.md`.
|
|
33
|
-
*/
|
|
34
|
-
import type { CryptoProvider } from '../types.js';
|
|
35
|
-
import { type Delegation } from '../identity/ucan.js';
|
|
36
|
-
/** A door names at most this many relays: enough that one going away doesn't matter */
|
|
37
|
-
export declare const MAX_DOOR_RELAYS = 3;
|
|
38
|
-
/** How long a knock waits in a mailbox, and so how old one may be when opened */
|
|
39
|
-
export declare const KNOCK_TTL_SECONDS: number;
|
|
40
|
-
/**
|
|
41
|
-
* How far a knock's own time may be from when the relay took it. A knock is
|
|
42
|
-
* dropped as soon as it is signed, so its time is checked against the relay's
|
|
43
|
-
* — which the knocker can't choose — and a note that ran out can't be used by
|
|
44
|
-
* dating a knock back to when it was good.
|
|
45
|
-
*/
|
|
46
|
-
export declare const KNOCK_DROP_WINDOW_SECONDS = 600;
|
|
47
|
-
/** What a door code says: where to knock, and whose door the owner says it is */
|
|
48
|
-
export interface DoorCode {
|
|
49
|
-
readonly v: 1;
|
|
50
|
-
/** The door key's public half: a compressed P-256 point, base64url. Knocks are sealed to it. */
|
|
51
|
-
readonly key: string;
|
|
52
|
-
/** The door's signing key's public half, likewise. Its hash is the door's topic. */
|
|
53
|
-
readonly sign: string;
|
|
54
|
-
/** Relays whose mailboxes hold knocks on it, 1–3 */
|
|
55
|
-
readonly relays: ReadonlyArray<string>;
|
|
56
|
-
/** Who the owner says they are — shown to the knocker, and proves nothing */
|
|
57
|
-
readonly name?: string;
|
|
58
|
-
}
|
|
59
|
-
/** What a knock carries, signed by the knocker's session key */
|
|
60
|
-
export interface KnockBody {
|
|
61
|
-
readonly v: 2;
|
|
62
|
-
/** The door knocked on: its key. Binds the knock to this door. */
|
|
63
|
-
readonly door: string;
|
|
64
|
-
/** The knocker's account */
|
|
65
|
-
readonly from: string;
|
|
66
|
-
/** The name they give */
|
|
67
|
-
readonly name: string;
|
|
68
|
-
/** The invite to the space for two they made */
|
|
69
|
-
readonly invite: string;
|
|
70
|
-
readonly note?: string;
|
|
71
|
-
/** When it was signed, Unix seconds */
|
|
72
|
-
readonly at: number;
|
|
73
|
-
/** The session key that signed it */
|
|
74
|
-
readonly session: string;
|
|
75
|
-
/** The note from `from` to `session`: one token */
|
|
76
|
-
readonly proof: Delegation;
|
|
77
|
-
}
|
|
78
|
-
/** A knock that opened and checked out */
|
|
79
|
-
export interface OpenedKnock {
|
|
80
|
-
readonly from: string;
|
|
81
|
-
readonly name: string;
|
|
82
|
-
readonly note?: string;
|
|
83
|
-
readonly invite: string;
|
|
84
|
-
/** The id of the space for two */
|
|
85
|
-
readonly pairSpace: string;
|
|
86
|
-
/** When it was signed, ms */
|
|
87
|
-
readonly at: number;
|
|
88
|
-
}
|
|
89
|
-
/** Cuts text to at most `max` characters without splitting one (a surrogate pair stays whole) */
|
|
90
|
-
export declare function clip(text: string, max: number): string;
|
|
91
|
-
/** Encodes a door code: what goes in a link or a QR code */
|
|
92
|
-
export declare function encodeDoorCode(code: Omit<DoorCode, 'v'>): string;
|
|
93
|
-
/**
|
|
94
|
-
* Reads a door code, or a link carrying one after `#door=` or `door=`.
|
|
95
|
-
* @throws When it isn't one, saying why
|
|
96
|
-
*/
|
|
97
|
-
export declare function parseDoorCode(text: string): DoorCode;
|
|
98
|
-
/** Why a value is not a door code, or null */
|
|
99
|
-
export declare function checkDoorCode(value: unknown): string | null;
|
|
100
|
-
/**
|
|
101
|
-
* The mailbox topic of a door: a hash of its signing key. The relay can't tell
|
|
102
|
-
* whose door it is, and can check that whoever clears it holds that key.
|
|
103
|
-
*/
|
|
104
|
-
export declare function doorTopic(sign: string): Promise<string>;
|
|
105
|
-
/**
|
|
106
|
-
* What a door's owner signs to clear knocks from a relay's mailbox: the topic,
|
|
107
|
-
* the relay's one-time challenge, and which knocks (`*` for all of them).
|
|
108
|
-
*/
|
|
109
|
-
export declare const purgeMessage: (topic: string, nonce: string, ids: ReadonlyArray<string> | null) => Uint8Array<ArrayBuffer>;
|
|
110
|
-
/** Signs a relay's purge challenge with the door's signing key */
|
|
111
|
-
export declare function signPurge(signKey: Uint8Array, topic: string, nonce: string, ids: ReadonlyArray<string> | null): Promise<string>;
|
|
112
|
-
export declare function signAnswer(signKey: Uint8Array, pairSpace: string, did: string): Promise<string>;
|
|
113
|
-
export declare function checkAnswer(sign: string, pairSpace: string, did: string, signature: string): Promise<boolean>;
|
|
114
|
-
/** A knock's id: the hash of its sealed blob, as relays file it */
|
|
115
|
-
export declare function knockId(blob: string): Promise<string>;
|
|
116
|
-
/**
|
|
117
|
-
* Makes a knock: the body, signed by the session key, sealed to the door key.
|
|
118
|
-
* @returns The sealed blob, for relays' mailboxes
|
|
119
|
-
*/
|
|
120
|
-
export declare function sealKnock(door: string, knock: {
|
|
121
|
-
readonly from: string;
|
|
122
|
-
readonly name: string;
|
|
123
|
-
readonly invite: string;
|
|
124
|
-
readonly note?: string;
|
|
125
|
-
}, session: {
|
|
126
|
-
readonly did: string;
|
|
127
|
-
readonly key: CryptoKey;
|
|
128
|
-
readonly proof: Delegation;
|
|
129
|
-
}, provider: CryptoProvider): Promise<string>;
|
|
130
|
-
/**
|
|
131
|
-
* Opens a knock left on a door, and checks it through: sealed to this door;
|
|
132
|
-
* signed by a session key that its account's note vouches for, for the whole
|
|
133
|
-
* account and not by an agent; signed when the relay took it; recent; and
|
|
134
|
-
* carrying an invite to a private space that account made.
|
|
135
|
-
* @param doorKey The door key's private scalar (`deriveDoorKeyBytes`)
|
|
136
|
-
* @param receivedAt When the relay took it, ms, as `fetch` says
|
|
137
|
-
* @returns The knock, or null when it is anything less
|
|
138
|
-
*/
|
|
139
|
-
export declare function openKnock(doorKey: Uint8Array, blob: string, receivedAt: number, provider: CryptoProvider): Promise<OpenedKnock | null>;
|
|
140
|
-
//# sourceMappingURL=doors.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"doors.d.ts","sourceRoot":"","sources":["../../src/doors/doors.ts"],"names":[],"mappings":"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"}
|
package/dist/doors/doors.js
DELETED
|
@@ -1,226 +0,0 @@
|
|
|
1
|
-
import { contactKeyPair, contactPublicKey, isContactPublicKey, signWithScalar, verifyWithPoint, } from '../identity/contact-key.js';
|
|
2
|
-
import { openValueFrom, sealValueTo } from '../identity/hpke.js';
|
|
3
|
-
import { didToPublicKey } from '../identity/did.js';
|
|
4
|
-
import { noteCovers, verifyNote, UCAN_CLOCK_SKEW_SECONDS } from '../identity/ucan.js';
|
|
5
|
-
import { ACCOUNT_REQUIREMENT } from '../identity/abilities.js';
|
|
6
|
-
import { canonicalize } from '../schema/version.js';
|
|
7
|
-
import { parseSpaceInvite } from '../space/space-manager.js';
|
|
8
|
-
import { checkSpace, soleFounder } from '../space/constitution.js';
|
|
9
|
-
import { checkRelays } from '../space/roles.js';
|
|
10
|
-
import { sha256 } from '../utils/hash.js';
|
|
11
|
-
import { isObject } from '../utils/guards.js';
|
|
12
|
-
import { base64UrlDecode, base64UrlEncode, utf8Decode, utf8Encode } from '../utils/encoding.js';
|
|
13
|
-
/** A door names at most this many relays: enough that one going away doesn't matter */
|
|
14
|
-
export const MAX_DOOR_RELAYS = 3;
|
|
15
|
-
/** How long a knock waits in a mailbox, and so how old one may be when opened */
|
|
16
|
-
export const KNOCK_TTL_SECONDS = 14 * 24 * 3600;
|
|
17
|
-
/**
|
|
18
|
-
* How far a knock's own time may be from when the relay took it. A knock is
|
|
19
|
-
* dropped as soon as it is signed, so its time is checked against the relay's
|
|
20
|
-
* — which the knocker can't choose — and a note that ran out can't be used by
|
|
21
|
-
* dating a knock back to when it was good.
|
|
22
|
-
*/
|
|
23
|
-
export const KNOCK_DROP_WINDOW_SECONDS = 600;
|
|
24
|
-
const MAX_NAME = 64;
|
|
25
|
-
const MAX_NOTE = 2000;
|
|
26
|
-
const MAX_INVITE = 6000;
|
|
27
|
-
const MAX_PROOF = 4096;
|
|
28
|
-
/** Cuts text to at most `max` characters without splitting one (a surrogate pair stays whole) */
|
|
29
|
-
export function clip(text, max) {
|
|
30
|
-
const chars = Array.from(text);
|
|
31
|
-
return chars.length <= max ? text : chars.slice(0, max).join('');
|
|
32
|
-
}
|
|
33
|
-
/** Encodes a door code: what goes in a link or a QR code */
|
|
34
|
-
export function encodeDoorCode(code) {
|
|
35
|
-
const problem = checkDoorCode({ v: 1, ...code });
|
|
36
|
-
if (problem)
|
|
37
|
-
throw new Error(problem);
|
|
38
|
-
return base64UrlEncode(utf8Encode(canonicalize({
|
|
39
|
-
v: 1,
|
|
40
|
-
key: code.key,
|
|
41
|
-
sign: code.sign,
|
|
42
|
-
relays: [...code.relays],
|
|
43
|
-
...(code.name ? { name: code.name } : {}),
|
|
44
|
-
})));
|
|
45
|
-
}
|
|
46
|
-
/**
|
|
47
|
-
* Reads a door code, or a link carrying one after `#door=` or `door=`.
|
|
48
|
-
* @throws When it isn't one, saying why
|
|
49
|
-
*/
|
|
50
|
-
export function parseDoorCode(text) {
|
|
51
|
-
const trimmed = text.trim();
|
|
52
|
-
const found = /(?:^|[#?&])door=([A-Za-z0-9_-]+)/.exec(trimmed);
|
|
53
|
-
const raw = found ? found[1] : trimmed;
|
|
54
|
-
let parsed;
|
|
55
|
-
try {
|
|
56
|
-
parsed = JSON.parse(utf8Decode(base64UrlDecode(raw)));
|
|
57
|
-
}
|
|
58
|
-
catch {
|
|
59
|
-
throw new Error('That is not a door code — it may be cut short.');
|
|
60
|
-
}
|
|
61
|
-
if (!isDoorCode(parsed))
|
|
62
|
-
throw new Error(`That door code doesn't work: ${checkDoorCode(parsed)}`);
|
|
63
|
-
const code = parsed;
|
|
64
|
-
return Object.freeze({
|
|
65
|
-
v: 1,
|
|
66
|
-
key: code.key,
|
|
67
|
-
sign: code.sign,
|
|
68
|
-
relays: Object.freeze([...code.relays]),
|
|
69
|
-
...(code.name ? { name: code.name } : {}),
|
|
70
|
-
});
|
|
71
|
-
}
|
|
72
|
-
const isDoorCode = (value) => checkDoorCode(value) === null;
|
|
73
|
-
/** Why a value is not a door code, or null */
|
|
74
|
-
export function checkDoorCode(value) {
|
|
75
|
-
const code = value;
|
|
76
|
-
if (!isObject(code) || code.v !== 1)
|
|
77
|
-
return 'it is not a version 1 door';
|
|
78
|
-
if (!isContactPublicKey(code.key))
|
|
79
|
-
return 'its key is not a P-256 public key';
|
|
80
|
-
if (!isContactPublicKey(code.sign) || code.sign === code.key)
|
|
81
|
-
return 'its signing key is not a P-256 public key of its own';
|
|
82
|
-
if (!Array.isArray(code.relays) || code.relays.length === 0 || code.relays.length > MAX_DOOR_RELAYS) {
|
|
83
|
-
return `it names 1–${MAX_DOOR_RELAYS} relays`;
|
|
84
|
-
}
|
|
85
|
-
const relays = checkRelays(code.relays);
|
|
86
|
-
if (relays)
|
|
87
|
-
return relays;
|
|
88
|
-
if (code.name !== undefined && (typeof code.name !== 'string' || Array.from(code.name).length > MAX_NAME))
|
|
89
|
-
return `its name is text of at most ${MAX_NAME} characters`;
|
|
90
|
-
return null;
|
|
91
|
-
}
|
|
92
|
-
/**
|
|
93
|
-
* The mailbox topic of a door: a hash of its signing key. The relay can't tell
|
|
94
|
-
* whose door it is, and can check that whoever clears it holds that key.
|
|
95
|
-
*/
|
|
96
|
-
export async function doorTopic(sign) {
|
|
97
|
-
return base64UrlEncode(await sha256(utf8Encode(`minca/door-topic/v1|${sign}`)));
|
|
98
|
-
}
|
|
99
|
-
/**
|
|
100
|
-
* What a door's owner signs to clear knocks from a relay's mailbox: the topic,
|
|
101
|
-
* the relay's one-time challenge, and which knocks (`*` for all of them).
|
|
102
|
-
*/
|
|
103
|
-
export const purgeMessage = (topic, nonce, ids) => utf8Encode(`minca/door-purge/v1|${topic}|${nonce}|${ids ? [...ids].sort().join(',') : '*'}`);
|
|
104
|
-
/** Signs a relay's purge challenge with the door's signing key */
|
|
105
|
-
export function signPurge(signKey, topic, nonce, ids) {
|
|
106
|
-
return signWithScalar(signKey, purgeMessage(topic, nonce, ids));
|
|
107
|
-
}
|
|
108
|
-
/**
|
|
109
|
-
* The answer to a knock: the door's owner, signing with the door's signing key
|
|
110
|
-
* that the account which joined the space for two is theirs. Without it,
|
|
111
|
-
* whoever joined first — someone the invite was passed on to — would be taken
|
|
112
|
-
* for the person behind the door.
|
|
113
|
-
*/
|
|
114
|
-
const answerMessage = (pairSpace, did) => utf8Encode(`minca/knock-answer/v1|${pairSpace}|${did}`);
|
|
115
|
-
export function signAnswer(signKey, pairSpace, did) {
|
|
116
|
-
return signWithScalar(signKey, answerMessage(pairSpace, did));
|
|
117
|
-
}
|
|
118
|
-
export function checkAnswer(sign, pairSpace, did, signature) {
|
|
119
|
-
return verifyWithPoint(sign, answerMessage(pairSpace, did), signature);
|
|
120
|
-
}
|
|
121
|
-
/** A knock's id: the hash of its sealed blob, as relays file it */
|
|
122
|
-
export async function knockId(blob) {
|
|
123
|
-
return base64UrlEncode(await sha256(utf8Encode(blob)));
|
|
124
|
-
}
|
|
125
|
-
/** The HPKE label a knock is sealed under; bound to `{ door }`, the door key */
|
|
126
|
-
const KNOCK_LABEL = 'minca/knock/v1';
|
|
127
|
-
/**
|
|
128
|
-
* Makes a knock: the body, signed by the session key, sealed to the door key.
|
|
129
|
-
* @returns The sealed blob, for relays' mailboxes
|
|
130
|
-
*/
|
|
131
|
-
export async function sealKnock(door, knock, session, provider) {
|
|
132
|
-
const note = knock.note ? clip(knock.note.trim(), MAX_NOTE) : undefined;
|
|
133
|
-
const body = {
|
|
134
|
-
v: 2,
|
|
135
|
-
door,
|
|
136
|
-
from: knock.from,
|
|
137
|
-
name: clip(knock.name.trim(), MAX_NAME) || 'Someone',
|
|
138
|
-
invite: knock.invite,
|
|
139
|
-
...(note ? { note } : {}),
|
|
140
|
-
at: Math.floor(Date.now() / 1000),
|
|
141
|
-
session: session.did,
|
|
142
|
-
proof: session.proof,
|
|
143
|
-
};
|
|
144
|
-
const sig = base64UrlEncode(await provider.sign(session.key, utf8Encode(canonicalize(body))));
|
|
145
|
-
return sealValueTo(door, KNOCK_LABEL, { door }, { body, sig });
|
|
146
|
-
}
|
|
147
|
-
/**
|
|
148
|
-
* Opens a knock left on a door, and checks it through: sealed to this door;
|
|
149
|
-
* signed by a session key that its account's note vouches for, for the whole
|
|
150
|
-
* account and not by an agent; signed when the relay took it; recent; and
|
|
151
|
-
* carrying an invite to a private space that account made.
|
|
152
|
-
* @param doorKey The door key's private scalar (`deriveDoorKeyBytes`)
|
|
153
|
-
* @param receivedAt When the relay took it, ms, as `fetch` says
|
|
154
|
-
* @returns The knock, or null when it is anything less
|
|
155
|
-
*/
|
|
156
|
-
export async function openKnock(doorKey, blob, receivedAt, provider) {
|
|
157
|
-
const door = contactPublicKey(doorKey);
|
|
158
|
-
const opened = await openValueFrom(await contactKeyPair(doorKey), KNOCK_LABEL, { door }, blob);
|
|
159
|
-
if (!isObject(opened))
|
|
160
|
-
return null;
|
|
161
|
-
const { body, sig } = opened;
|
|
162
|
-
if (!isObject(body) || typeof sig !== 'string')
|
|
163
|
-
return null;
|
|
164
|
-
if (body.v !== 2 || body.door !== door)
|
|
165
|
-
return null;
|
|
166
|
-
if (typeof body.from !== 'string' || typeof body.session !== 'string' || typeof body.name !== 'string')
|
|
167
|
-
return null;
|
|
168
|
-
if (Array.from(body.name).length > MAX_NAME)
|
|
169
|
-
return null;
|
|
170
|
-
if (typeof body.invite !== 'string' || body.invite.length > MAX_INVITE)
|
|
171
|
-
return null;
|
|
172
|
-
if (!isObject(body.proof) || canonicalize(body.proof).length > MAX_PROOF)
|
|
173
|
-
return null;
|
|
174
|
-
if (body.note !== undefined && (typeof body.note !== 'string' || Array.from(body.note).length > MAX_NOTE))
|
|
175
|
-
return null;
|
|
176
|
-
if (typeof body.at !== 'number' || !Number.isSafeInteger(body.at) || !Number.isFinite(receivedAt))
|
|
177
|
-
return null;
|
|
178
|
-
const now = Math.floor(Date.now() / 1000);
|
|
179
|
-
if (body.at > now + UCAN_CLOCK_SKEW_SECONDS || body.at < now - KNOCK_TTL_SECONDS)
|
|
180
|
-
return null;
|
|
181
|
-
// Signed when it was dropped, not dated back to when a note was still good.
|
|
182
|
-
const dropped = Math.floor(receivedAt / 1000);
|
|
183
|
-
if (body.at > dropped + UCAN_CLOCK_SKEW_SECONDS || body.at < dropped - KNOCK_DROP_WINDOW_SECONDS)
|
|
184
|
-
return null;
|
|
185
|
-
// Signed by the session key it names…
|
|
186
|
-
let signed = false;
|
|
187
|
-
try {
|
|
188
|
-
const key = await provider.importPublicKey(didToPublicKey(body.session).publicKeyBytes);
|
|
189
|
-
signed = await provider.verify(key, base64UrlDecode(sig), utf8Encode(canonicalize(body)));
|
|
190
|
-
}
|
|
191
|
-
catch {
|
|
192
|
-
return null;
|
|
193
|
-
}
|
|
194
|
-
if (!signed)
|
|
195
|
-
return null;
|
|
196
|
-
// …which the account it claims had delegated to when it signed.
|
|
197
|
-
const checked = await verifyNote(body.proof, provider, { at: body.at }).catch(() => null);
|
|
198
|
-
if (!checked?.valid || checked.audience !== body.session || checked.root !== body.from)
|
|
199
|
-
return null;
|
|
200
|
-
// Knocking makes a space and hands out its invite: only a note that may write
|
|
201
|
-
// for the whole account may. An app given one space, or a key the account
|
|
202
|
-
// trusts less, may not.
|
|
203
|
-
if (!noteCovers(checked.note, ACCOUNT_REQUIREMENT))
|
|
204
|
-
return null;
|
|
205
|
-
// A private space the knocker made, with its key: anything else isn't a space for two from them.
|
|
206
|
-
let invited;
|
|
207
|
-
try {
|
|
208
|
-
invited = parseSpaceInvite(body.invite);
|
|
209
|
-
}
|
|
210
|
-
catch {
|
|
211
|
-
return null;
|
|
212
|
-
}
|
|
213
|
-
if (soleFounder(invited.space) !== body.from || invited.space.visibility !== 'private' || !invited.key)
|
|
214
|
-
return null;
|
|
215
|
-
if ((await checkSpace(invited.space)) !== null)
|
|
216
|
-
return null;
|
|
217
|
-
return Object.freeze({
|
|
218
|
-
from: body.from,
|
|
219
|
-
name: clip(body.name, MAX_NAME) || 'Someone',
|
|
220
|
-
...(typeof body.note === 'string' && body.note ? { note: body.note } : {}),
|
|
221
|
-
invite: body.invite,
|
|
222
|
-
pairSpace: invited.space.id,
|
|
223
|
-
at: body.at * 1000,
|
|
224
|
-
});
|
|
225
|
-
}
|
|
226
|
-
//# sourceMappingURL=doors.js.map
|
package/dist/doors/doors.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"doors.js","sourceRoot":"","sources":["../../src/doors/doors.ts"],"names":[],"mappings":"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"}
|
package/dist/doors/index.d.ts
DELETED
|
@@ -1,9 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @module doors
|
|
3
|
-
* Doors and knocks — see `doors.ts`, and `node.doors` for the API an app uses.
|
|
4
|
-
*/
|
|
5
|
-
export { encodeDoorCode, parseDoorCode, checkDoorCode, doorTopic, knockId, sealKnock, openKnock, signPurge, purgeMessage, signAnswer, checkAnswer, clip, KNOCK_DROP_WINDOW_SECONDS, MAX_DOOR_RELAYS, KNOCK_TTL_SECONDS, } from './doors.js';
|
|
6
|
-
export type { DoorCode, KnockBody, OpenedKnock } from './doors.js';
|
|
7
|
-
export { createMailboxClient } from '../network/mailbox.js';
|
|
8
|
-
export type { MailboxClient, MailboxOptions, MailItem } from '../network/mailbox.js';
|
|
9
|
-
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/doors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,aAAa,EACb,aAAa,EACb,SAAS,EACT,OAAO,EACP,SAAS,EACT,SAAS,EACT,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,EACX,IAAI,EACJ,yBAAyB,EACzB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}
|
package/dist/doors/index.js
DELETED
|
@@ -1,7 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @module doors
|
|
3
|
-
* Doors and knocks — see `doors.ts`, and `node.doors` for the API an app uses.
|
|
4
|
-
*/
|
|
5
|
-
export { encodeDoorCode, parseDoorCode, checkDoorCode, doorTopic, knockId, sealKnock, openKnock, signPurge, purgeMessage, signAnswer, checkAnswer, clip, KNOCK_DROP_WINDOW_SECONDS, MAX_DOOR_RELAYS, KNOCK_TTL_SECONDS, } from './doors.js';
|
|
6
|
-
export { createMailboxClient } from '../network/mailbox.js';
|
|
7
|
-
//# sourceMappingURL=index.js.map
|
package/dist/doors/index.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/doors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,aAAa,EACb,aAAa,EACb,SAAS,EACT,OAAO,EACP,SAAS,EACT,SAAS,EACT,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,EACX,IAAI,EACJ,yBAAyB,EACzB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}
|
package/docs/doors.md
DELETED
|
@@ -1,151 +0,0 @@
|
|
|
1
|
-
# Doors
|
|
2
|
-
|
|
3
|
-
A door is an address an account hands out on purpose, so that someone it
|
|
4
|
-
shares no space with can ask to become a contact. The keys, the door code, the
|
|
5
|
-
topic, the relay mailbox and the sealed knock are protocol
|
|
6
|
-
([spec 07](https://github.com/leifriksheim/minca/blob/main/spec/07-doors.md)):
|
|
7
|
-
a relay and a door's owner check them.
|
|
8
|
-
|
|
9
|
-
What this page covers is a convention built on them, not part of the protocol:
|
|
10
|
-
where an account keeps its doors, how a knock becomes a space for two, and the
|
|
11
|
-
answer that tells the knocker who was behind the door. Peers that have never
|
|
12
|
-
heard of `std.door`, `std.knock` or `std.knock-answer` sync, store and judge
|
|
13
|
-
them like any other record. Only the devices of one account, and the two
|
|
14
|
-
people at either side of a door, have to agree on what follows.
|
|
15
|
-
|
|
16
|
-
## `std.door`
|
|
17
|
-
|
|
18
|
-
An account's doors are `std.door` records in its **contacts space**
|
|
19
|
-
([spec 03](https://github.com/leifriksheim/minca/blob/main/spec/03-spaces.md)),
|
|
20
|
-
which only the account can find and every one of its devices holds.
|
|
21
|
-
|
|
22
|
-
| Field | Type | |
|
|
23
|
-
| -------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
|
|
24
|
-
| `id` | string, 16–64 chars | The door id both keys are derived from ([spec 07 §1](https://github.com/leifriksheim/minca/blob/main/spec/07-doors.md)) |
|
|
25
|
-
| `relays` | string[], 1–3 | Relay URLs, each passing the door code's relay check ([spec 07 §3](https://github.com/leifriksheim/minca/blob/main/spec/07-doors.md)) |
|
|
26
|
-
| `name` | string ≤64, optional | The name the code gives whoever knocks |
|
|
27
|
-
| `label` | string ≤64, optional | What the owner calls the door; never leaves the contacts space |
|
|
28
|
-
|
|
29
|
-
Rules: `onePer: ['id']`. A device treats as a door only a verified `std.door`
|
|
30
|
-
whose root is the account itself. **Closing** a door is deleting its record:
|
|
31
|
-
its knocks are no longer fetched, and knocks already opened stop being
|
|
32
|
-
offered.
|
|
33
|
-
|
|
34
|
-
_Source: `packages/core/src/schemas/contacts.ts` (`door`), `packages/core/src/node/node.ts` (Doors). Tests: `packages/core/tests/doors.test.ts` ("node.doors")._
|
|
35
|
-
|
|
36
|
-
## The exchange
|
|
37
|
-
|
|
38
|
-
```
|
|
39
|
-
Anna relay(s) Leif
|
|
40
|
-
│ doors.open() → std.door, code │
|
|
41
|
-
│ ── code, out of band (a link, a QR code, a bio) ─────────────────────────────▶ │
|
|
42
|
-
│ spaces.create(private), define answers│
|
|
43
|
-
│ invite(role: editor) │
|
|
44
|
-
│ ◀── drop(topic, sealed knock) ── to each │
|
|
45
|
-
│ std.knock { space, … } │
|
|
46
|
-
│ fetch(topic) ──▶ ◀── mail [knock] │
|
|
47
|
-
│ open + check (spec 07 §6) │
|
|
48
|
-
│ accept: spaces.join(invite); std.contact { did: Leif, space, door } │
|
|
49
|
-
│ purge(knock) ──▶ │
|
|
50
|
-
│ once a member there: std.knock-answer { sig } │
|
|
51
|
-
│ ═════════════════ the space for two syncs ═══════════════════════════════════▶ │
|
|
52
|
-
│ answer checks out: std.contact { did: Anna }, invite │
|
|
53
|
-
│ closed, std.knock deleted │
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
**Knocking.** The knocker:
|
|
57
|
-
|
|
58
|
-
1. parses the code, and refuses one of its own doors;
|
|
59
|
-
2. creates a private space named `"<own name> & <code name>"` with the `team`
|
|
60
|
-
role preset, defines `std.knock-answer` in it, and makes an editor invite;
|
|
61
|
-
3. seals the knock ([spec 07 §6](https://github.com/leifriksheim/minca/blob/main/spec/07-doors.md))
|
|
62
|
-
and drops it at **every** relay the code names, since any one of them may
|
|
63
|
-
lose it (the reference relay keeps its mailbox in memory, so a restart
|
|
64
|
-
loses what it held);
|
|
65
|
-
4. if no relay answers `dropped`, leaves the space and fails;
|
|
66
|
-
5. otherwise writes `std.knock { space, name, door, sign, invite }` in its
|
|
67
|
-
contacts space.
|
|
68
|
-
|
|
69
|
-
**Opening.** Besides the checks the protocol requires, the owner's devices
|
|
70
|
-
skip knocks from the account itself, from accounts its contact list marks
|
|
71
|
-
blocked, and whose space for two it already holds (accepted here or on
|
|
72
|
-
another device).
|
|
73
|
-
|
|
74
|
-
**Accepting.** The owner joins the invite and writes
|
|
75
|
-
`std.contact { did: from, name, space, door: <door id> }`, keeping a name it
|
|
76
|
-
already had for that account. It purges the knock from the door's relays.
|
|
77
|
-
Once its membership in the space for two has landed, it writes the
|
|
78
|
-
**answer**:
|
|
79
|
-
|
|
80
|
-
```
|
|
81
|
-
std.knock-answer { sig } sig = door signing key over UTF-8("minca/knock-answer/v1|" + space + "|" + own account DID)
|
|
82
|
-
```
|
|
83
|
-
|
|
84
|
-
`sig` is ECDSA P-256 / SHA-256, P1363 (64 bytes), base64url, like every
|
|
85
|
-
signature of a door signing key. The owner then rewrites the contact without
|
|
86
|
-
`door`. Until then the contact carries the door id, so any device of the
|
|
87
|
-
account can write the answer.
|
|
88
|
-
|
|
89
|
-
**Settling.** For each `std.knock`, the knocker's devices look in its space for
|
|
90
|
-
a verified `std.knock-answer` whose author is a member other than themselves
|
|
91
|
-
and whose `sig` checks out against the `std.knock`'s `sign`. When one does, they
|
|
92
|
-
write `std.contact { did: <that author>, name: <their profile name, else the code's>, space }`,
|
|
93
|
-
close the invite, and delete the `std.knock`. Anyone else who joined with the
|
|
94
|
-
invite (it may have been passed on) is never taken for the person behind the
|
|
95
|
-
door, and nobody joins after. Such a person shows up in `contacts.others` for
|
|
96
|
-
the knocker to see.
|
|
97
|
-
|
|
98
|
-
A `std.knock` nobody answered within the knock TTL (14 days) plus a day is let
|
|
99
|
-
go: the knocker leaves the space and deletes the record. One whose space is no
|
|
100
|
-
longer held is deleted.
|
|
101
|
-
|
|
102
|
-
**Dismissing** a knock purges it from the door's relays; nothing else is
|
|
103
|
-
written, and the knocker is not blocked. **Clearing** a door purges all of its
|
|
104
|
-
knocks and keeps the door open.
|
|
105
|
-
|
|
106
|
-
| Collection | Fields | Rules | Where |
|
|
107
|
-
| ------------------ | ------------------------------------------------------------------------------- | ------------------- | ------------------------ |
|
|
108
|
-
| `std.knock` | `space` ≤256, `name` ≤64, `door` ≤64, `sign` ≤64, `invite` ≤8000 (all required) | `onePer: ['space']` | Knocker's contacts space |
|
|
109
|
-
| `std.knock-answer` | `sig` ≤200 (required) | — | The space for two |
|
|
110
|
-
| `std.contact` | adds `door` ≤64, optional | as before | Owner's contacts space |
|
|
111
|
-
|
|
112
|
-
**Who may.** Knocking and accepting create or join a space, so they need a note
|
|
113
|
-
that grants `/account/write` for the whole account, as `contacts.ask`
|
|
114
|
-
does, and the contact key. Doors are the person's: a node whose note lacks
|
|
115
|
-
`/account/write`, such as an agent's, refuses to open, close, clear, read,
|
|
116
|
-
knock, accept or dismiss. A home never gives an agent the
|
|
117
|
-
contact key in the first place ([spec 06 §2.8](https://github.com/leifriksheim/minca/blob/main/spec/06-nodes-and-sessions.md)).
|
|
118
|
-
|
|
119
|
-
_Source: `packages/core/src/node/node.ts` (Doors), `packages/core/src/node/types.ts` (`NodeDoors`), `packages/core/src/schemas/contacts.ts` (`knock`, `knockAnswer`, `contact`), `packages/core/src/doors/doors.ts` (`signAnswer`, `checkAnswer`), `packages/core/src/session/auth.ts` (`grant`). Tests: `packages/core/tests/doors.test.ts` ("node.doors"), `packages/core/tests/records-only.test.ts`._
|
|
120
|
-
|
|
121
|
-
## `node.doors`
|
|
122
|
-
|
|
123
|
-
The calls are listed with the rest of the node, in [node.md](node.md#doors).
|
|
124
|
-
`node.doors.knocks()` fetches; it doesn't watch, though the mailbox supports
|
|
125
|
-
`watch`. The default mailbox client opens a fresh WebSocket to a relay for
|
|
126
|
-
each call.
|
|
127
|
-
|
|
128
|
-
_Source: `packages/core/src/network/mailbox.ts` (`createMailboxClient`)._
|
|
129
|
-
|
|
130
|
-
## Not yet built
|
|
131
|
-
|
|
132
|
-
- **Live knocks.** Watching a door's topic, so a knock shows as it arrives.
|
|
133
|
-
- **Retrying a knock** that reached no relay, or whose relays lost it
|
|
134
|
-
(restart), until it is answered or expires. A retry is a fresh knock, signed
|
|
135
|
-
and dropped at once.
|
|
136
|
-
|
|
137
|
-
## Planned: names
|
|
138
|
-
|
|
139
|
-
The protocol side of names (a handle resolving to a door code, and a checked
|
|
140
|
-
handle on a knock) is planned in
|
|
141
|
-
[spec 07 §9](https://github.com/leifriksheim/minca/blob/main/spec/07-doors.md).
|
|
142
|
-
On this side:
|
|
143
|
-
|
|
144
|
-
- `node.doors.knock` accepts a handle wherever it takes a code.
|
|
145
|
-
- A knock whose handle checks out shows as "@leif.bsky.social ✓", and as the
|
|
146
|
-
plain name otherwise.
|
|
147
|
-
- **Who may knock.** A door gains a policy in its `std.door` record (never
|
|
148
|
-
published): `anyone` (default), `follows` or `mutuals` on the handle's
|
|
149
|
-
network. Follows are `app.bsky.graph.follow` records in the owner's own
|
|
150
|
-
repository, read from their PDS, with no AppView. Knocks that don't match
|
|
151
|
-
are kept but shown apart.
|