Skip to content

Tag: proxy

Overview

The proxy tag links Nostr events to their original source from other protocols. It allows Nostr events bridged from other protocols (such as ActivityPub, AT Protocol, RSS, or the Web) to reference back to the source object.

Specification

PropertyValue
Tag Nameproxy
Defined inNIP-48
Required forCan be used with any event kind

Format

["proxy", "<id>", "<protocol>"]

Where:

  • <id> is the ID of the source object, with format varying by protocol
  • <protocol> is the name of the protocol (e.g., "activitypub")

Usage Description

The proxy tag indicates that an event did not originate on the Nostr protocol but was bridged from elsewhere on the web. It provides the original ID and protocol source.

The ID must be universally unique, regardless of the protocol, and its format depends on the protocol being used.

Supported Protocols

ProtocolID formatExample
activitypubURLhttps://gleasonator.com/objects/9f524868-c1a0-4ee7-ad51-aaa23d68b526
atprotoAT URIat://did:plc:zhbjlbmir5dganqhueg7y4i3/app.bsky.feed.post/3jt5hlibeol2i
rssURL with guid fragmenthttps://soapbox.pub/rss/feed.xml#https%3A%2F%2Fsoapbox.pub%2Fblog%2Fmostr-fediverse-nostr-bridge
webURLhttps://twitter.com/jack/status/20

Examples

Example with ActivityPub Source

json
[
  "proxy",
  "https://gleasonator.com/objects/8f6fac53-4f66-4c6e-ac7d-92e5e78c3e79",
  "activitypub"
]

Example with Web Source

json
[
  "proxy",
  "https://twitter.com/jack/status/20",
  "web"
]

Complete Event Example

json
{
  "kind": 1,
  "content": "I'm vegan btw",
  "tags": [
    [
      "proxy",
      "https://gleasonator.com/objects/8f6fac53-4f66-4c6e-ac7d-92e5e78c3e79",
      "activitypub"
    ]
  ],
  "pubkey": "79c2cae114ea28a981e7559b4fe7854a473521a8d22a66bbab9fa248eb820ff6",
  "created_at": 1691091365,
  "id": "55920b758b9c7b17854b6e3d44e6a02a83d1cb49e1227e75a30426dea94d4cb2",
  "sig": "a72f12c08f18e85d98fb92ae89e2fe63e48b8864c5e10fbdd5335f3c9f936397a6b0a7350efe251f8168b1601d7012d4a6d0ee6eec958067cf22a14f5a5ea579"
}

Client Behavior

Clients may use this information to:

  • Reconcile duplicated content bridged from other protocols
  • Display a link to the source object
  • Visually indicate that the content originated from another platform

Relay Behavior

No specific relay behavior is defined for events with proxy tags. Relays should process these events normally.

References

No directly related tags at this time.

Notes

The list of supported protocols may be extended in the future as more bridges to other protocols are developed.