mirror of
https://github.com/nostr-protocol/nips.git
synced 2024-09-20 06:45:49 -04:00
59 lines
2.0 KiB
Markdown
59 lines
2.0 KiB
Markdown
NIP-07
|
|
======
|
|
|
|
`window.nostr` capability for web browsers
|
|
------------------------------------------
|
|
|
|
`draft` `optional`
|
|
|
|
The `window.nostr` object may be made available by web browsers or extensions and websites or web-apps may make use of it after checking its availability.
|
|
|
|
That object must define the following methods:
|
|
|
|
```
|
|
async window.nostr.getPublicKey(): string // returns a public key as hex
|
|
async window.nostr.signEvent(event: { created_at: number, kind: number, tags: string[][], content: string }): Event // takes an event object, adds `id`, `pubkey` and `sig` and returns it
|
|
```
|
|
|
|
Aside from these two basic above, the following functions can also be implemented optionally:
|
|
```
|
|
async window.nostr.getRelays(): { [url: string]: {read: boolean, write: boolean} } // returns a basic map of relay urls to relay policies
|
|
async window.nostr.nip04.encrypt(pubkey, plaintext): string // returns ciphertext and iv as specified in nip-04 (deprecated)
|
|
async window.nostr.nip04.decrypt(pubkey, ciphertext): string // takes ciphertext and iv as specified in nip-04 (deprecated)
|
|
async window.nostr.nip44.encrypt(pubkey, plaintext): string // returns ciphertext as specified in nip-44
|
|
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.
|