Skip to content

feat(cat-voices): Update stakeAssets endpoint to v2 #3621

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 31, 2025
Merged

feat(cat-voices): Update stakeAssets endpoint to v2 #3621

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 11 additions & 7 deletions ...s/packages/internal/catalyst_voices_repositories/lib/src/api/dio_cat_gateway_service.dart
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,8 @@ import 'package:dio/dio.dart';
/// # Catalyst Gateway API.
/// The Catalyst Gateway API provides realtime data for all prior, current and future Catalyst Voices voting events.
///
/// Based on OpenAPI Catalyst Gateway API version 0.3.0
/// catalyst-openapi/v0.3.0 - https://github.com/input-output-hk/catalyst-voices/releases/tag/catalyst-openapi%2Fv0.3.0
/// Based on OpenAPI Catalyst Gateway API version 0.7.0
/// catalyst-openapi/v0.7.0 - https://github.com/input-output-hk/catalyst-voices/releases/tag/catalyst-openapi%2Fv0.7.0
abstract interface class CatGatewayService {
factory CatGatewayService.dio({
required String baseUrl,
Expand Down Expand Up @@ -98,12 +98,15 @@ abstract interface class CatGatewayService {
bool? showAllInvalid,
});

/// Get staked assets.
/// Get staked assets v2.
/// This endpoint returns the total Cardano's staked assets to the corresponded
/// user's stake address.
///
/// [stakeAddress] The stake address of the user.
/// [stakeAddress] Cardano stake address, also known as a reward address. An optional stake address of the user.
/// Should be a valid Bech32 encoded address followed by the https://cips.cardano.org/cip/CIP-19/#stake-addresses.
/// If missing, a list of associated stake addresses is taken using the RBAC token (for one RBAC registration
/// chain could be assigned multiple different cardano stake addresses). An aggregated response would be returned
/// (total ADA sum across all stake addresses, an aggregated native tokens list across all stake addresses etc.)
/// [network] Cardano network type.
/// If omitted network type is identified from the stake address.
/// If specified it must be correspondent to the network type encoded in the stake address.
Expand All @@ -113,7 +116,7 @@ abstract interface class CatGatewayService {
/// [asat] A time point at which the assets should be calculated.
/// If omitted latest slot number is used.
Future<FullStakeInfo> stakeAssets({
required String stakeAddress,
String? stakeAddress,
Network? network,
String? asat,
String? authorization,
Expand Down Expand Up @@ -209,14 +212,15 @@ final class DioCatGatewayService implements CatGatewayService {

@override
Future<FullStakeInfo> stakeAssets({
required String stakeAddress,
String? stakeAddress,
Network? network,
String? asat,
String? authorization,
}) {
return _dio.get<Map<String, dynamic>, FullStakeInfo>(
'/v1/cardano/assets/$stakeAddress',
'/v2/cardano/assets',
queryParameters: {
'stake_address': ?stakeAddress,
'network': ?network?.value,
'asat': ?asat,
},
Expand Down
Loading