From 963e628466a8e44ad1dbcf120a82c89f2dc0f700 Mon Sep 17 00:00:00 2001 From: Egge Date: Sun, 14 Apr 2024 12:05:49 +0200 Subject: [PATCH] added cmd queue --- 07.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/07.md b/07.md index 6c663224..94450678 100644 --- a/07.md +++ b/07.md @@ -24,6 +24,35 @@ async window.nostr.nip44.encrypt(pubkey, plaintext): string // returns ciphertex async window.nostr.nip44.decrypt(pubkey, ciphertext): string // takes ciphertext as specified in nip-44 ``` +## Command Queue + +In order to avoid race conditions the object SHOULD have a `cmd` property. +This object is defined as follows + +```ts +window.nostr.cmd: (() => void)[] +``` + +Browsers or extensions SHOULD invoke all callbacks queued once it has finished loading. +After that it should shadow the `push` method on `cmd` +to immediately invoke subsequent queues + +This allows consumers to queue up calls to the NIP-07 providers even before +it is present. + +### Examples + +Queue a command + +```js +window.nostr = window.nostr || { cmd: [] }; + +window.nostr.cmd.push(() => { + const pk = window.nostr.getPublicKey(); + // do something with pk +}); +``` + ### Implementation See https://github.com/aljazceru/awesome-nostr#nip-07-browser-extensions.