How usagiapp/oauth2-rpc works
OAuth2 RPC is a Kotlin library and sample app for obtaining a Discord OAuth2 token, fetching the authorized user, connecting to Discord’s Gateway, and publishing Rich Presence. The sample app owns the end-to-end flow; the library supplies REST, Gateway, presence-building, and asset-registration capabilities. The Gateway and OAuth/REST flow are visible in excerpts, while some REST helper behavior and protocol details are only documented or indexed, so those links are omitted where ownership is not shown.
Main entry points: Main.kt OAuth and demo flow · Gateway.kt Gateway client · Rest.kt REST route client · Util.kt OAuth and JSON utilities
Components 14
Sample application
- OAuth and demo flow
app/src/main/kotlin/com/discord/oauth2rpc/Main.kt
Discord transport
- Gateway client
library/src/main/kotlin/com/discord/oauth2rpc/Gateway.kt - REST route client
library/src/main/kotlin/com/discord/oauth2rpc/Rest.kt
Presence and assets
- Presence builders
library/src/main/kotlin/com/discord/oauth2rpc/structures/Presence.kt - Asset registrar
library/src/main/kotlin/com/discord/oauth2rpc/DiscordAssetRegistrar.kt
Models and utilities
- Protocol models
library/src/main/kotlin/com/discord/oauth2rpc/Interface.kt - OAuth and JSON utilities
library/src/main/kotlin/com/discord/oauth2rpc/utils/Util.kt - Bit field base
library/src/main/kotlin/com/discord/oauth2rpc/utils/BitField.kt - Gateway intents
library/src/main/kotlin/com/discord/oauth2rpc/utils/Intents.kt - Gateway capabilities
library/src/main/kotlin/com/discord/oauth2rpc/utils/GatewayCapabilities.kt - Activity flags
library/src/main/kotlin/com/discord/oauth2rpc/utils/ActivityFlags.kt - Protocol constants
library/src/main/kotlin/com/discord/oauth2rpc/utils/Constants.kt
Other components
- Application user
- Discord services
Connections 18
- Application user → OAuth and demo flow: starts flow
app/src/main/kotlin/com/discord/oauth2rpc/Main.kt - OAuth and demo flow → REST route client: fetches user
app/src/main/kotlin/com/discord/oauth2rpc/Main.kt - OAuth and demo flow → Gateway client: connects Gateway
app/src/main/kotlin/com/discord/oauth2rpc/Main.kt - OAuth and demo flow → Presence builders: builds activities
app/src/main/kotlin/com/discord/oauth2rpc/Main.kt - OAuth and demo flow → OAuth and JSON utilities: gets external assets
app/src/main/kotlin/com/discord/oauth2rpc/Main.kt - OAuth and JSON utilities → REST route client: posts assets
library/src/main/kotlin/com/discord/oauth2rpc/utils/Util.kt - Asset registrar → REST route client: registers assets
library/src/main/kotlin/com/discord/oauth2rpc/DiscordAssetRegistrar.kt - Gateway client → Discord services: opens WebSocket
- REST route client → Discord services: sends HTTP requests
- Gateway client → Gateway intents: uses flags
library/src/main/kotlin/com/discord/oauth2rpc/Gateway.kt - Gateway client → Gateway capabilities: uses flags
library/src/main/kotlin/com/discord/oauth2rpc/Gateway.kt - Gateway intents → Bit field base: extends
library/src/main/kotlin/com/discord/oauth2rpc/utils/Intents.kt - Gateway capabilities → Bit field base: extends
library/src/main/kotlin/com/discord/oauth2rpc/utils/GatewayCapabilities.kt - Activity flags → Bit field base: extends
library/src/main/kotlin/com/discord/oauth2rpc/utils/ActivityFlags.kt - Presence builders → OAuth and JSON utilities: resolves emoji
library/src/main/kotlin/com/discord/oauth2rpc/structures/Presence.kt - OAuth and demo flow → Protocol models: parses token
- Gateway client → Protocol models: uses packet models
- OAuth and demo flow → Protocol constants: uses defaults