Skip to content

Document RPC over IPC#8246

Merged
markmandel merged 6 commits into
discord:mainfrom
5XS:patch-rpc
Apr 2, 2026
Merged

Document RPC over IPC#8246
markmandel merged 6 commits into
discord:mainfrom
5XS:patch-rpc

Conversation

@5XS
Copy link
Copy Markdown
Contributor

@5XS 5XS commented Mar 25, 2026

I opened new PR, because of new codebase. I edited everything you commented and moved to mdx
@advaith1 #8087

@5XS 5XS requested a review from a team as a code owner March 25, 2026 17:21
@5XS 5XS requested review from colinloretz and removed request for a team March 25, 2026 17:21
Copy link
Copy Markdown
Contributor

@markmandel markmandel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Having a play with this - going to check a few more things on our end, but overall looking good to me, other than the one item I found.

Comment thread developers/topics/rpc.mdx Outdated
Copy link
Copy Markdown
Contributor

@markmandel markmandel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So I learned new things going through all this! I have some IPC commands working!

Lots of events to remove from the list (see comments) - but some to keep, but we don't have reference for them in this current PR.

@advaith1 WDYT? remove the ones without references or keep them?

I'm almost tempted to keep them, and then either myself or @advaith1 can do a fast follow PR to add references once this one is merged.

How do we all feel?

Comment thread developers/topics/rpc.mdx Outdated
Comment thread developers/topics/rpc.mdx Outdated
Comment thread developers/topics/rpc.mdx Outdated
Comment thread developers/topics/rpc.mdx Outdated
Comment on lines +221 to +222
| ENTITLEMENT_CREATE | sent when a user purchases or receives a new entitlement (SKU/Game) |
| ENTITLEMENT_DELETE | sent when an entitlement is removed |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't have references for these. I believe they work, but haven't been able to test them.

Do we want to remove them for now, and come back around when someone is ready to write a reference for
ENTITLEMENT_CREATE and ENTITLEMENT_DELETE ?

@advaith1 @5XS WDYT?

@advaith1 we could probably add in the references for these in a fast follow in these docs though after this PR is merged?

Comment thread developers/topics/rpc.mdx

| Name | Description |
|------------------------------------------------------------------------------|-----------------------------------------------------------------|
| [DISPATCH](/developers/topics/rpc#commands-and-events-rpc-events) | event dispatch |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Any particular reason to remove all the anchor links? I don't have super strong opinions on this, but they seem handy to have.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

advaith1 said to remove them since they led to nowhere

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

aaand it was before you changed the structure. So I can probably return it (or maybe I misunderstood something)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The ones that don't have references to link to - definitely remove, but we could keep the ones that do point to existing links.

https://docs.discord.com/developers/topics/rpc#getchannels works for example (drops a little low, but better than not having) - so I'd advocate for putthing this back in -- they are handy.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

aaand it was before you changed the structure. So I can probably return it (or maybe I misunderstood something)

heh, yeah there was that too 😁

All good, easy enough to diff and put it back.

Comment thread developers/topics/rpc.mdx Outdated
| MESSAGE_DELETE | sent when a message is deleted in a subscribed text channel |
| NOTIFICATION_CREATE | sent when the client receives a notification (mention or new message in eligible channels) |
| ACTIVITY_JOIN | sent when the user clicks a Rich Presence join invite in chat to join a game |
| ACTIVITY_SPECTATE | sent when the user clicks a Rich Presence spectate invite in chat to spectate a game |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also - this should work, but no reference for ACTIVITY_INVITE

Comment thread developers/topics/rpc.mdx Outdated
@markmandel
Copy link
Copy Markdown
Contributor

If you are interesting (and write Rust), this is the test bed I was using: https://github.com/markmandel/discord-ipc-example

@markmandel
Copy link
Copy Markdown
Contributor

If it makes things easier - for the items that don't have references, I'm happy to take on implementing that after this PR is done.

So - I'm happy to merge with:

  1. Add back in the anchor links for those items that have references to point to.
  2. Remove the listed items that I've highlighted above.

👍🏻 thanks for this work as well!

@5XS 5XS requested a review from markmandel April 2, 2026 17:23
Copy link
Copy Markdown
Contributor

@markmandel markmandel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's go! 😄

@markmandel markmandel merged commit 86d1f28 into discord:main Apr 2, 2026
3 checks passed
markmandel added a commit that referenced this pull request Apr 2, 2026
Add anchor links and full dispatch data structure documentation for
ACTIVITY_INVITE, CURRENT_USER_UPDATE, RELATIONSHIP_UPDATE,
ENTITLEMENT_CREATE, and ENTITLEMENT_DELETE, which were added to the
RPC Events table without reference sections.

Also did some minor cleanup of text, and linked to the Social SDK.

Continuation of work in #8246
markmandel added a commit that referenced this pull request Apr 2, 2026
Add anchor links and full dispatch data structure documentation for
ACTIVITY_INVITE, CURRENT_USER_UPDATE, RELATIONSHIP_UPDATE,
ENTITLEMENT_CREATE, and ENTITLEMENT_DELETE, which were added to the
RPC Events table without reference sections.

Also did some minor cleanup of text, and linked to the Social SDK.

Continuation of work in #8246
markmandel added a commit that referenced this pull request Apr 3, 2026
Add anchor links and full dispatch data structure documentation for
ACTIVITY_INVITE, CURRENT_USER_UPDATE, RELATIONSHIP_UPDATE,
ENTITLEMENT_CREATE, and ENTITLEMENT_DELETE, which were added to the
RPC Events table without reference sections.

Also did some minor cleanup of text, and linked to the Social SDK.

Continuation of work in #8246
markmandel added a commit that referenced this pull request Apr 3, 2026
* docs(rpc): add reference documentation for new IPC events

Add anchor links and full dispatch data structure documentation for
ACTIVITY_INVITE, CURRENT_USER_UPDATE, RELATIONSHIP_UPDATE,
ENTITLEMENT_CREATE, and ENTITLEMENT_DELETE, which were added to the
RPC Events table without reference sections.

Also did some minor cleanup of text, and linked to the Social SDK.

Continuation of work in #8246

* Added a changelog!
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants