@elizaos/plugin-nostr 2.0.0-alpha.7 → 2.0.0-beta.1

package/README.md

@@ -0,0 +1,200 @@
+# @elizaos/plugin-nostr
+
+Nostr decentralized messaging plugin for ElizaOS agents. Enables secure, encrypted direct messaging (NIP-04) over the Nostr protocol.
+
+## Features
+
+- **Encrypted Direct Messages (NIP-04)**: Send and receive encrypted DMs using the Nostr protocol
+- **Multi-relay Support**: Connect to multiple Nostr relays for redundancy
+- **Profile Management**: Publish and update your agent's Nostr profile (kind:0)
+- **DM Policy Control**: Configure who can message your agent (open, pairing, allowlist, disabled)
+
+## Installation
+
+```bash
+# npm
+npm install @elizaos/plugin-nostr
+
+# bun
+bun add @elizaos/plugin-nostr
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `NOSTR_PRIVATE_KEY` | Private key (hex or nsec format) | Yes |
+| `NOSTR_RELAYS` | Comma-separated relay URLs | No |
+| `NOSTR_DM_POLICY` | DM policy: open, pairing, allowlist, disabled | No |
+| `NOSTR_ALLOW_FROM` | Comma-separated pubkeys for allowlist | No |
+| `NOSTR_ENABLED` | Enable/disable the plugin | No |
+
+### Agent Configuration
+
+```json
+{
+  "plugins": ["@elizaos/plugin-nostr"],
+  "pluginParameters": {
+    "NOSTR_PRIVATE_KEY": "your-private-key-hex-or-nsec",
+    "NOSTR_RELAYS": "wss://relay.damus.io,wss://nos.lol,wss://relay.nostr.band",
+    "NOSTR_DM_POLICY": "pairing"
+  }
+}
+```
+
+## Usage
+
+### Actions
+
+Nostr DMs and public notes are exposed through canonical connector actions. Use
+`source: "nostr"` when a request needs to target Nostr explicitly.
+
+| Primary action | Operation | Description |
+|----------------|-----------|-------------|
+| `MESSAGE` | `send` | Send an encrypted direct message to a Nostr pubkey |
+| `MESSAGE` | `read` | Read recent direct messages where the connector can fetch them |
+| `POST` | `send` | Publish a public Nostr note |
+| `POST` | `read` | Read recent relay feed posts |
+| `POST` | `search` | Search relay posts where supported |
+
+Profile updates remain a Nostr-specific profile capability outside the
+MESSAGE/POST connector action set.
+
+### Providers
+
+#### nostrIdentityContext
+
+Provides information about the bot's Nostr identity:
+- Public key (hex and npub)
+- Connected relays
+- Connection status
+
+#### nostrSenderContext
+
+Provides information about the current conversation partner:
+- Sender's pubkey (hex and npub)
+- Display name
+- Encryption status
+
+## DM Policies
+
+| Policy | Description |
+|--------|-------------|
+| `open` | Accept DMs from anyone |
+| `pairing` | Accept DMs and remember senders for future conversations |
+| `allowlist` | Only accept DMs from pubkeys in NOSTR_ALLOW_FROM |
+| `disabled` | Don't accept any DMs |
+
+## Nostr Concepts
+
+### Keys
+
+- **Private Key**: Used to sign events and decrypt messages. Keep this secret!
+- **Public Key**: Your identity on Nostr. Can be shared freely.
+- **npub/nsec**: Bech32-encoded formats for public/private keys
+
+### Events
+
+- **kind:0**: Profile metadata
+- **kind:4**: Encrypted DMs (NIP-04)
+
+### Relays
+
+Nostr relays are servers that store and forward events. Your agent connects to multiple relays for redundancy.
+
+## Example
+
+```typescript
+import { createAgent } from "@elizaos/core";
+import nostrPlugin from "@elizaos/plugin-nostr";
+
+const agent = await createAgent({
+  plugins: [nostrPlugin],
+  settings: {
+    NOSTR_PRIVATE_KEY: process.env.NOSTR_PRIVATE_KEY,
+    NOSTR_RELAYS: "wss://relay.damus.io,wss://nos.lol",
+    NOSTR_DM_POLICY: "pairing",
+  },
+});
+
+// The agent can now receive DMs and respond
+```
+
+## Security Considerations
+
+1. **Private Key Storage**: Never commit your private key to version control. Use environment variables or secure secret management.
+
+2. **Key Generation**: Generate keys using a reputable tool like `nip-06` or the `nostr-tools` library.
+
+3. **Relay Selection**: Choose relays carefully. Consider running your own relay for sensitive applications.
+
+4. **DM Policy**: Start with a restrictive policy and relax as needed.
+
+## Development
+
+### Building
+
+```bash
+cd typescript && npm run build
+```
+
+### Testing
+
+```bash
+npm test
+```
+
+## API Reference
+
+### NostrService
+
+#### Methods
+
+- `isConnected()`: Check if connected to relays
+- `getPublicKey()`: Get the bot's public key (hex)
+- `getNpub()`: Get the bot's npub
+- `getRelays()`: Get connected relay URLs
+- `sendDm(options)`: Send an encrypted DM
+- `publishProfile(profile)`: Publish profile metadata
+
+### Types
+
+```typescript
+interface NostrSettings {
+  privateKey: string;
+  publicKey: string;
+  relays: string[];
+  dmPolicy: "open" | "pairing" | "allowlist" | "disabled";
+  allowFrom: string[];
+  enabled: boolean;
+}
+
+interface NostrProfile {
+  name?: string;
+  displayName?: string;
+  about?: string;
+  picture?: string;
+  banner?: string;
+  nip05?: string;
+  lud16?: string;
+  website?: string;
+}
+
+interface NostrDmSendOptions {
+  toPubkey: string;
+  text: string;
+}
+
+interface NostrSendResult {
+  success: boolean;
+  eventId?: string;
+  relays: string[];
+  error?: string;
+}
+```
+
+## License
+
+MIT

package/auto-enable.ts

@@ -0,0 +1,20 @@
+// Auto-enable check for @elizaos/plugin-nostr.
+//
+// Plugin manifest entry-point — referenced by package.json's
+// `elizaos.plugin.autoEnableModule`. Keep this module light: env reads only,
+// no service init, no transitive imports of the full plugin runtime. The
+// auto-enable engine loads dozens of these per boot.
+import type { PluginAutoEnableContext } from "@elizaos/core";
+
+/** Enable when a `nostr` connector block is present and not explicitly disabled. */
+export function shouldEnable(ctx: PluginAutoEnableContext): boolean {
+  const c = (ctx.config?.connectors as Record<string, unknown> | undefined)?.nostr;
+  if (!c || typeof c !== "object") return false;
+  const config = c as Record<string, unknown>;
+  if (config.enabled === false) return false;
+  // The full per-connector field check (private key / relays) lives in the
+  // central engine's isConnectorConfigured. We delegate to a simple "block
+  // present + not explicitly disabled" check here; the central engine's
+  // stricter check remains as a fallback during migration.
+  return true;
+}

package/dist/src/accounts.d.ts

@@ -0,0 +1,15 @@
+import type { IAgentRuntime } from "@elizaos/core";
+import { type NostrSettings } from "./types.js";
+export declare const DEFAULT_NOSTR_ACCOUNT_ID = "default";
+export type NostrAccountConfig = Partial<Omit<NostrSettings, "relays" | "allowFrom" | "publicKey" | "accountId">> & {
+    accountId?: string;
+    id?: string;
+    relays?: string[] | string;
+    allowFrom?: string[] | string;
+};
+export declare function normalizeNostrAccountId(accountId?: unknown): string;
+export declare function listNostrAccountIds(runtime: IAgentRuntime): string[];
+export declare function resolveDefaultNostrAccountId(runtime: IAgentRuntime): string;
+export declare function readNostrAccountId(...sources: unknown[]): string | undefined;
+export declare function resolveNostrAccountSettings(runtime: IAgentRuntime, requestedAccountId?: string | null): NostrSettings;
+//# sourceMappingURL=accounts.d.ts.map

package/dist/src/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../src/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAA4C,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1F,eAAO,MAAM,wBAAwB,YAAY,CAAC;AAElD,MAAM,MAAM,kBAAkB,GAAG,OAAO,CACtC,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC,CACxE,GAAG;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;CAC/B,CAAC;AAoEF,wBAAgB,uBAAuB,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAInE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,EAAE,CAepE;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAQ3E;AAED,wBAAgB,kBAAkB,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,GAAG,SAAS,CA2B5E;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,aAAa,EACtB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,GACjC,aAAa,CAqCf"}

package/dist/src/accounts.js

@@ -0,0 +1,139 @@
+import { DEFAULT_NOSTR_RELAYS } from "./types.js";
+export const DEFAULT_NOSTR_ACCOUNT_ID = "default";
+function stringSetting(runtime, key) {
+    const value = runtime.getSetting(key);
+    if (typeof value === "string" && value.trim())
+        return value.trim();
+    return process.env[key];
+}
+function characterConfig(runtime) {
+    const settings = runtime.character?.settings;
+    const raw = settings?.nostr;
+    return raw && typeof raw === "object" ? raw : {};
+}
+function parseAccountsJson(runtime) {
+    const raw = stringSetting(runtime, "NOSTR_ACCOUNTS");
+    if (!raw)
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed)) {
+            return Object.fromEntries(parsed
+                .filter((item) => Boolean(item) && typeof item === "object")
+                .map((item) => [normalizeNostrAccountId(item.accountId ?? item.id), item]));
+        }
+        return parsed && typeof parsed === "object"
+            ? parsed
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+function allAccountConfigs(runtime) {
+    return {
+        ...(characterConfig(runtime).accounts ?? {}),
+        ...parseAccountsJson(runtime),
+    };
+}
+function accountConfig(runtime, accountId) {
+    const accounts = allAccountConfigs(runtime);
+    return accounts[accountId] ?? accounts[normalizeNostrAccountId(accountId)] ?? {};
+}
+function boolValue(value, fallback = true) {
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "string")
+        return value.trim().toLowerCase() !== "false";
+    return fallback;
+}
+function stringList(value) {
+    if (Array.isArray(value))
+        return value.map((item) => String(item).trim()).filter(Boolean);
+    if (typeof value === "string") {
+        return value
+            .split(",")
+            .map((item) => item.trim())
+            .filter(Boolean);
+    }
+    return [];
+}
+export function normalizeNostrAccountId(accountId) {
+    if (typeof accountId !== "string")
+        return DEFAULT_NOSTR_ACCOUNT_ID;
+    const trimmed = accountId.trim();
+    return trimmed || DEFAULT_NOSTR_ACCOUNT_ID;
+}
+export function listNostrAccountIds(runtime) {
+    const ids = new Set();
+    const config = characterConfig(runtime);
+    if (stringSetting(runtime, "NOSTR_PRIVATE_KEY") || config.privateKey) {
+        ids.add(DEFAULT_NOSTR_ACCOUNT_ID);
+    }
+    for (const id of Object.keys(allAccountConfigs(runtime))) {
+        ids.add(normalizeNostrAccountId(id));
+    }
+    return Array.from(ids.size ? ids : new Set([DEFAULT_NOSTR_ACCOUNT_ID])).sort((a, b) => a.localeCompare(b));
+}
+export function resolveDefaultNostrAccountId(runtime) {
+    const requested = stringSetting(runtime, "NOSTR_DEFAULT_ACCOUNT_ID") ??
+        stringSetting(runtime, "NOSTR_ACCOUNT_ID");
+    if (requested)
+        return normalizeNostrAccountId(requested);
+    const ids = listNostrAccountIds(runtime);
+    return ids.includes(DEFAULT_NOSTR_ACCOUNT_ID) ? DEFAULT_NOSTR_ACCOUNT_ID : ids[0];
+}
+export function readNostrAccountId(...sources) {
+    for (const source of sources) {
+        if (!source || typeof source !== "object")
+            continue;
+        const record = source;
+        const parameters = record.parameters && typeof record.parameters === "object"
+            ? record.parameters
+            : {};
+        const data = record.data && typeof record.data === "object"
+            ? record.data
+            : {};
+        const metadata = record.metadata && typeof record.metadata === "object"
+            ? record.metadata
+            : {};
+        const nostr = data.nostr && typeof data.nostr === "object" ? data.nostr : {};
+        const value = record.accountId ??
+            parameters.accountId ??
+            data.accountId ??
+            nostr.accountId ??
+            metadata.accountId;
+        if (typeof value === "string" && value.trim())
+            return normalizeNostrAccountId(value);
+    }
+    return undefined;
+}
+export function resolveNostrAccountSettings(runtime, requestedAccountId) {
+    const accountId = normalizeNostrAccountId(requestedAccountId ?? resolveDefaultNostrAccountId(runtime));
+    const base = characterConfig(runtime);
+    const account = accountConfig(runtime, accountId);
+    const allowEnv = accountId === DEFAULT_NOSTR_ACCOUNT_ID;
+    const relays = stringList(account.relays ?? base.relays ?? (allowEnv ? stringSetting(runtime, "NOSTR_RELAYS") : undefined));
+    const allowFrom = stringList(account.allowFrom ??
+        base.allowFrom ??
+        (allowEnv ? stringSetting(runtime, "NOSTR_ALLOW_FROM") : undefined));
+    return {
+        accountId,
+        privateKey: account.privateKey ??
+            base.privateKey ??
+            (allowEnv ? stringSetting(runtime, "NOSTR_PRIVATE_KEY") : undefined) ??
+            "",
+        publicKey: "",
+        relays: relays.length ? relays : DEFAULT_NOSTR_RELAYS,
+        dmPolicy: (account.dmPolicy ??
+            base.dmPolicy ??
+            (allowEnv ? stringSetting(runtime, "NOSTR_DM_POLICY") : undefined) ??
+            "pairing"),
+        allowFrom,
+        profile: account.profile ?? base.profile,
+        enabled: boolValue(account.enabled ??
+            base.enabled ??
+            (allowEnv ? stringSetting(runtime, "NOSTR_ENABLED") : undefined)),
+    };
+}
+//# sourceMappingURL=accounts.js.map

package/dist/src/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../src/accounts.ts"],"names":[],"mappings":"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"}

package/dist/src/actions/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Export all Nostr actions.
+ *
+ * Nostr DMs route through MESSAGE. Public notes route through POST.
+ */
+export { publishProfile } from "./publishProfile.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/actions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/actions/index.js

@@ -0,0 +1,7 @@
+/**
+ * Export all Nostr actions.
+ *
+ * Nostr DMs route through MESSAGE. Public notes route through POST.
+ */
+export { publishProfile } from "./publishProfile.js";
+//# sourceMappingURL=index.js.map

package/dist/src/actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/actions/publishProfile.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Publish profile action for Nostr plugin.
+ */
+import { type Action } from "@elizaos/core";
+export declare const publishProfile: Action;
+//# sourceMappingURL=publishProfile.d.ts.map

package/dist/src/actions/publishProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishProfile.d.ts","sourceRoot":"","sources":["../../../src/actions/publishProfile.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,MAAM,EAQZ,MAAM,eAAe,CAAC;AAiCvB,eAAO,MAAM,cAAc,EAAE,MAoJ5B,CAAC"}

package/dist/src/actions/publishProfile.js

@@ -0,0 +1,157 @@
+/**
+ * Publish profile action for Nostr plugin.
+ */
+import { composePromptFromState, ModelType, parseJSONObjectFromText, } from "@elizaos/core";
+import { normalizeNostrAccountId, readNostrAccountId } from "../accounts.js";
+import { NOSTR_SERVICE_NAME } from "../types.js";
+const PUBLISH_PROFILE_TEMPLATE = `# Task: Extract Nostr profile data
+Based on the conversation, determine what profile information to update.
+
+Recent conversation:
+{{recentMessages}}
+
+Respond with JSON only, no prose or fences, listing only the fields to update:
+
+{
+  "name": "optional display name",
+  "about": "optional bio",
+  "picture": "optional profile picture URL",
+  "banner": "optional banner URL",
+  "nip05": "optional user@domain.com",
+  "lud16": "optional lightning address",
+  "website": "optional website URL"
+}`;
+const MAX_NOSTR_PROFILE_FIELD_CHARS = 500;
+const MAX_NOSTR_PROFILE_RELAYS = 10;
+const NOSTR_PROFILE_ACTION_TIMEOUT_MS = 30_000;
+function truncateProfileField(value) {
+    return typeof value === "string" && value.trim()
+        ? value.trim().slice(0, MAX_NOSTR_PROFILE_FIELD_CHARS)
+        : undefined;
+}
+export const publishProfile = {
+    name: "NOSTR_PUBLISH_PROFILE",
+    similes: ["UPDATE_NOSTR_PROFILE", "SET_NOSTR_PROFILE", "NOSTR_PROFILE"],
+    description: "Publish or update the bot's Nostr profile (kind:0 metadata)",
+    descriptionCompressed: "publish update bot Nostr profile (kind: 0 metadata)",
+    contexts: ["social_posting", "connectors"],
+    contextGate: { anyOf: ["social_posting", "connectors"] },
+    roleGate: { minRole: "USER" },
+    parameters: [
+        {
+            name: "name",
+            description: "Display name for the Nostr profile.",
+            required: false,
+            schema: { type: "string" },
+        },
+        {
+            name: "about",
+            description: "Profile bio/about text.",
+            required: false,
+            schema: { type: "string" },
+        },
+        {
+            name: "picture",
+            description: "Profile picture URL.",
+            required: false,
+            schema: { type: "string" },
+        },
+    ],
+    validate: async (_runtime, message, _state) => {
+        return message.content.source === "nostr";
+    },
+    handler: async (runtime, message, state, _options, callback) => {
+        const nostrService = runtime.getService(NOSTR_SERVICE_NAME);
+        if (!nostrService?.isConnected()) {
+            if (callback) {
+                callback({ text: "Nostr service is not available.", source: "nostr" });
+            }
+            return { success: false, error: "Nostr service not available" };
+        }
+        const requestedAccountId = normalizeNostrAccountId(readNostrAccountId(_options, message.content) ?? nostrService.getAccountId(runtime));
+        // Get or compose state
+        const currentState = state ?? (await runtime.composeState(message));
+        // Compose prompt
+        const prompt = await composePromptFromState({
+            template: PUBLISH_PROFILE_TEMPLATE,
+            state: currentState,
+        });
+        // Extract parameters using LLM
+        let profileInfo = null;
+        for (let attempt = 0; attempt < 3; attempt++) {
+            const response = await runtime.useModel(ModelType.TEXT_SMALL, {
+                prompt,
+            });
+            const actionParams = parseJSONObjectFromText(String(response));
+            if (actionParams) {
+                profileInfo = {
+                    name: truncateProfileField(actionParams.name),
+                    displayName: truncateProfileField(actionParams.displayName),
+                    about: truncateProfileField(actionParams.about),
+                    picture: truncateProfileField(actionParams.picture),
+                    banner: truncateProfileField(actionParams.banner),
+                    nip05: truncateProfileField(actionParams.nip05),
+                    lud16: truncateProfileField(actionParams.lud16),
+                    website: truncateProfileField(actionParams.website),
+                };
+                break;
+            }
+        }
+        if (!profileInfo) {
+            if (callback) {
+                callback({
+                    text: "I couldn't understand the profile information. Please try again.",
+                    source: "nostr",
+                });
+            }
+            return { success: false, error: "Could not extract profile parameters" };
+        }
+        // Publish profile
+        const timeoutMs = NOSTR_PROFILE_ACTION_TIMEOUT_MS;
+        const result = await nostrService.publishProfile({
+            ...profileInfo,
+            accountId: requestedAccountId,
+        });
+        if (!result.success) {
+            if (callback) {
+                callback({
+                    text: `Failed to publish profile: ${result.error}`,
+                    source: "nostr",
+                });
+            }
+            return { success: false, error: result.error };
+        }
+        if (callback) {
+            callback({
+                text: "Profile published successfully.",
+                source: message.content.source,
+            });
+        }
+        return {
+            success: true,
+            data: {
+                eventId: result.eventId,
+                relays: result.relays?.slice(0, MAX_NOSTR_PROFILE_RELAYS),
+                profile: profileInfo,
+                timeoutMs,
+                accountId: requestedAccountId,
+            },
+        };
+    },
+    examples: [
+        [
+            {
+                name: "{{user1}}",
+                content: { text: "Update your profile name to 'Bot Assistant'" },
+            },
+            {
+                name: "{{agent}}",
+                content: {
+                    text: "I'll update my Nostr profile.",
+                    actions: ["NOSTR_PUBLISH_PROFILE"],
+                },
+            },
+        ],
+    ],
+};
+//# sourceMappingURL=publishProfile.js.map

package/dist/src/actions/publishProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishProfile.js","sourceRoot":"","sources":["../../../src/actions/publishProfile.ts"],"names":[],"mappings":"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"}

package/dist/src/connector-account-provider.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Nostr ConnectorAccountManager provider.
+ *
+ * Adapts the multi-account scaffolding in `accounts.ts` to the
+ * `ConnectorAccountProvider` contract from
+ * `@elizaos/core/connectors/account-manager`.
+ *
+ * Source of truth for accounts is character settings (`character.settings.nostr`)
+ * + NOSTR_ACCOUNTS JSON env var + single-account env vars (NOSTR_PRIVATE_KEY,
+ * NOSTR_RELAYS, NOSTR_DM_POLICY).
+ *
+ * AccountKey is the nostr pubkey (hex). Role is `OWNER` since the private key
+ * is the user's identity. Public key is derived at service start time, so
+ * `externalId` may be empty until the service has resolved it; the manager
+ * tolerates this.
+ */
+import type { ConnectorAccountProvider, IAgentRuntime } from "@elizaos/core";
+export declare const NOSTR_PROVIDER_ID = "nostr";
+export declare function createNostrConnectorAccountProvider(runtime: IAgentRuntime): ConnectorAccountProvider;
+//# sourceMappingURL=connector-account-provider.d.ts.map

package/dist/src/connector-account-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-account-provider.d.ts","sourceRoot":"","sources":["../../src/connector-account-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAIV,wBAAwB,EACxB,aAAa,EACd,MAAM,eAAe,CAAC;AASvB,eAAO,MAAM,iBAAiB,UAAU,CAAC;AA+BzC,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,aAAa,GACrB,wBAAwB,CAiC1B"}