Fixes for build

Reviewed-on: #31

.gitignore

@@ -8,4 +8,5 @@ devtools_options.yaml
 untranslated.txt
 generate_protos.sh
 update_dep.sh
-.vscode/
+.vscode/
+GeneratedPluginRegistrant.swift

api/gateway/chain/config.yml

@@ -55,3 +55,6 @@ key_management:
     namespace: ""
     mount_path: kv
     key_prefix: gateway/chain/wallets
+
+cache:
+  wallet_balance_ttl_seconds: 120

api/gateway/chain/internal/server/internal/serverimp.go

@@ -34,9 +34,10 @@ type Imp struct {
 
 type config struct {
 	*grpcapp.Config `yaml:",inline"`
-	Chains          []chainConfig       `yaml:"chains"`
+	Chains          []chainConfig                `yaml:"chains"`
-	ServiceWallet   serviceWalletConfig `yaml:"service_wallet"`
+	ServiceWallet   serviceWalletConfig          `yaml:"service_wallet"`
-	KeyManagement   keymanager.Config   `yaml:"key_management"`
+	KeyManagement   keymanager.Config            `yaml:"key_management"`
+	Settings        gatewayservice.CacheSettings `yaml:"cache"`
 }
 
 type chainConfig struct {
@@ -111,11 +112,12 @@ func (i *Imp) Start() error {
 			gatewayservice.WithServiceWallet(walletConfig),
 			gatewayservice.WithKeyManager(keyManager),
 			gatewayservice.WithTransferExecutor(executor),
+			gatewayservice.WithSettings(cfg.Settings),
 		}
 		return gatewayservice.NewService(logger, repo, producer, opts...), nil
 	}
 
-	app, err := grpcapp.NewApp(i.logger, "chain_gateway", cfg.Config, i.debug, repoFactory, serviceFactory)
+	app, err := grpcapp.NewApp(i.logger, "chain", cfg.Config, i.debug, repoFactory, serviceFactory)
 	if err != nil {
 		return err
 	}

api/gateway/chain/internal/service/gateway/commands/wallet/balance.go

@@ -4,7 +4,10 @@ import (
 	"context"
 	"errors"
 	"strings"
+	"time"
 
+	"github.com/tech/sendico/gateway/chain/internal/service/gateway/shared"
+	"github.com/tech/sendico/gateway/chain/storage/model"
 	"github.com/tech/sendico/pkg/api/routers/gsresponse"
 	"github.com/tech/sendico/pkg/merrors"
 	"github.com/tech/sendico/pkg/mservice"
@@ -14,6 +17,8 @@ import (
 	"google.golang.org/protobuf/types/known/timestamppb"
 )
 
+const fallbackBalanceCacheTTL = 2 * time.Minute
+
 type getWalletBalanceCommand struct {
 	deps Deps
 }
@@ -48,30 +53,88 @@ func (c *getWalletBalanceCommand) Execute(ctx context.Context, req *chainv1.GetW
 
 	balance, chainErr := onChainWalletBalance(ctx, c.deps, wallet)
 	if chainErr != nil {
-		c.deps.Logger.Warn("on-chain balance fetch failed, falling back to stored balance", zap.Error(chainErr), zap.String("wallet_ref", walletRef))
+		c.deps.Logger.Warn("on-chain balance fetch failed, attempting cached balance", zap.Error(chainErr), zap.String("wallet_ref", walletRef))
 		stored, err := c.deps.Storage.Wallets().GetBalance(ctx, walletRef)
 		if err != nil {
 			if errors.Is(err, merrors.ErrNoData) {
-				c.deps.Logger.Warn("stored balance not found", zap.String("wallet_ref", walletRef))
+				c.deps.Logger.Warn("cached balance not found", zap.String("wallet_ref", walletRef))
-				return gsresponse.NotFound[chainv1.GetWalletBalanceResponse](c.deps.Logger, mservice.ChainGateway, err)
+				return gsresponse.Auto[chainv1.GetWalletBalanceResponse](c.deps.Logger, mservice.ChainGateway, chainErr)
 			}
 			return gsresponse.Auto[chainv1.GetWalletBalanceResponse](c.deps.Logger, mservice.ChainGateway, err)
 		}
+		if c.isCachedBalanceStale(stored) {
+			c.deps.Logger.Warn("cached balance is stale",
+				zap.String("wallet_ref", walletRef),
+				zap.Time("calculated_at", stored.CalculatedAt),
+				zap.Duration("ttl", c.cacheTTL()),
+			)
+			return gsresponse.Auto[chainv1.GetWalletBalanceResponse](c.deps.Logger, mservice.ChainGateway, chainErr)
+		}
 		return gsresponse.Success(&chainv1.GetWalletBalanceResponse{Balance: toProtoWalletBalance(stored)})
 	}
 
-	return gsresponse.Success(&chainv1.GetWalletBalanceResponse{Balance: onChainBalanceToProto(balance)})
+	calculatedAt := c.now()
+	c.persistCachedBalance(ctx, walletRef, balance, calculatedAt)
+
+	return gsresponse.Success(&chainv1.GetWalletBalanceResponse{
+		Balance: onChainBalanceToProto(balance, calculatedAt),
+	})
 }
 
-func onChainBalanceToProto(balance *moneyv1.Money) *chainv1.WalletBalance {
+func onChainBalanceToProto(balance *moneyv1.Money, calculatedAt time.Time) *chainv1.WalletBalance {
 	if balance == nil {
 		return nil
 	}
-	zero := &moneyv1.Money{Currency: balance.Currency, Amount: "0"}
+	zero := zeroMoney(balance.Currency)
 	return &chainv1.WalletBalance{
 		Available:       balance,
 		PendingInbound:  zero,
 		PendingOutbound: zero,
-		CalculatedAt:    timestamppb.Now(),
+		CalculatedAt:    timestamppb.New(calculatedAt.UTC()),
 	}
 }
+
+func (c *getWalletBalanceCommand) persistCachedBalance(ctx context.Context, walletRef string, available *moneyv1.Money, calculatedAt time.Time) {
+	if available == nil {
+		return
+	}
+	record := &model.WalletBalance{
+		WalletRef:       walletRef,
+		Available:       shared.CloneMoney(available),
+		PendingInbound:  zeroMoney(available.Currency),
+		PendingOutbound: zeroMoney(available.Currency),
+		CalculatedAt:    calculatedAt,
+	}
+	if err := c.deps.Storage.Wallets().SaveBalance(ctx, record); err != nil {
+		c.deps.Logger.Warn("failed to cache wallet balance", zap.String("wallet_ref", walletRef), zap.Error(err))
+	}
+}
+
+func (c *getWalletBalanceCommand) isCachedBalanceStale(balance *model.WalletBalance) bool {
+	if balance == nil || balance.CalculatedAt.IsZero() {
+		return true
+	}
+	return c.now().After(balance.CalculatedAt.Add(c.cacheTTL()))
+}
+
+func (c *getWalletBalanceCommand) cacheTTL() time.Duration {
+	if c.deps.BalanceCacheTTL > 0 {
+		return c.deps.BalanceCacheTTL
+	}
+	// Fallback to sane default if not configured.
+	return fallbackBalanceCacheTTL
+}
+
+func (c *getWalletBalanceCommand) now() time.Time {
+	if c.deps.Clock != nil {
+		return c.deps.Clock.Now().UTC()
+	}
+	return time.Now().UTC()
+}
+
+func zeroMoney(currency string) *moneyv1.Money {
+	if strings.TrimSpace(currency) == "" {
+		return nil
+	}
+	return &moneyv1.Money{Currency: currency, Amount: "0"}
+}

api/gateway/chain/internal/service/gateway/commands/wallet/deps.go

@@ -2,10 +2,12 @@ package wallet
 
 import (
 	"context"
+	"time"
 
 	"github.com/tech/sendico/gateway/chain/internal/keymanager"
 	"github.com/tech/sendico/gateway/chain/internal/service/gateway/shared"
 	"github.com/tech/sendico/gateway/chain/storage"
+	clockpkg "github.com/tech/sendico/pkg/clock"
 	"github.com/tech/sendico/pkg/mlogger"
 )
 
@@ -14,6 +16,8 @@ type Deps struct {
 	Networks         map[string]shared.Network
 	KeyManager       keymanager.Manager
 	Storage          storage.Repository
+	Clock            clockpkg.Clock
+	BalanceCacheTTL  time.Duration
 	EnsureRepository func(context.Context) error
 }
 

api/gateway/chain/internal/service/gateway/options.go

@@ -67,3 +67,10 @@ func WithClock(clk clockpkg.Clock) Option {
 		}
 	}
 }
+
+// WithSettings applies gateway settings.
+func WithSettings(settings CacheSettings) Option {
+	return func(s *Service) {
+		s.settings = settings.withDefaults()
+	}
+}

api/gateway/chain/internal/service/gateway/service.go

@@ -36,6 +36,8 @@ type Service struct {
 	producer msg.Producer
 	clock    clockpkg.Clock
 
+	settings CacheSettings
+
 	networks      map[string]shared.Network
 	serviceWallet shared.ServiceWallet
 	keyManager    keymanager.Manager
@@ -52,6 +54,7 @@ func NewService(logger mlogger.Logger, repo storage.Repository, producer msg.Pro
 		storage:  repo,
 		producer: producer,
 		clock:    clockpkg.System{},
+		settings: defaultSettings(),
 		networks: map[string]shared.Network{},
 	}
 
@@ -69,6 +72,7 @@ func NewService(logger mlogger.Logger, repo storage.Repository, producer msg.Pro
 	if svc.networks == nil {
 		svc.networks = map[string]shared.Network{}
 	}
+	svc.settings = svc.settings.withDefaults()
 
 	svc.commands = commands.NewRegistry(commands.RegistryDeps{
 		Wallet:   commandsWalletDeps(svc),
@@ -130,6 +134,8 @@ func commandsWalletDeps(s *Service) wallet.Deps {
 		Networks:         s.networks,
 		KeyManager:       s.keyManager,
 		Storage:          s.storage,
+		Clock:            s.clock,
+		BalanceCacheTTL:  s.settings.walletBalanceCacheTTL(),
 		EnsureRepository: s.ensureRepository,
 	}
 }

api/gateway/chain/internal/service/gateway/settings.go

@@ -0,0 +1,30 @@
+package gateway
+
+import "time"
+
+const defaultWalletBalanceCacheTTL = 120 * time.Second
+
+// CacheSettings holds tunable gateway behaviour.
+type CacheSettings struct {
+	WalletBalanceCacheTTLSeconds int `yaml:"wallet_balance_ttl_seconds"`
+}
+
+func defaultSettings() CacheSettings {
+	return CacheSettings{
+		WalletBalanceCacheTTLSeconds: int(defaultWalletBalanceCacheTTL.Seconds()),
+	}
+}
+
+func (s CacheSettings) withDefaults() CacheSettings {
+	if s.WalletBalanceCacheTTLSeconds <= 0 {
+		s.WalletBalanceCacheTTLSeconds = int(defaultWalletBalanceCacheTTL.Seconds())
+	}
+	return s
+}
+
+func (s CacheSettings) walletBalanceCacheTTL() time.Duration {
+	if s.WalletBalanceCacheTTLSeconds <= 0 {
+		return defaultWalletBalanceCacheTTL
+	}
+	return time.Duration(s.WalletBalanceCacheTTLSeconds) * time.Second
+}

api/gateway/chain/main.go

@@ -13,5 +13,5 @@ func factory(logger mlogger.Logger, file string, debug bool) (server.Application
 }
 
 func main() {
-	smain.RunServer("main", appversion.Create(), factory)
+	smain.RunServer("gateway", appversion.Create(), factory)
 }

api/gateway/mntx/internal/server/internal/serverimp.go

@@ -125,7 +125,7 @@ func (i *Imp) Start() error {
 		return svc, nil
 	}
 
-	app, err := grpcapp.NewApp(i.logger, "mntx_gateway", cfg.Config, i.debug, nil, serviceFactory)
+	app, err := grpcapp.NewApp(i.logger, "monetix", cfg.Config, i.debug, nil, serviceFactory)
 	if err != nil {
 		return err
 	}
@@ -163,7 +163,7 @@ func (i *Imp) loadConfig() (*config, error) {
 	}
 
 	if cfg.Metrics == nil {
-		cfg.Metrics = &grpcapp.MetricsConfig{Address: ":9404"}
+		cfg.Metrics = &grpcapp.MetricsConfig{Address: ":9405"}
 	}
 
 	return cfg, nil

api/gateway/mntx/main.go

@@ -13,5 +13,5 @@ func factory(logger mlogger.Logger, file string, debug bool) (server.Application
 }
 
 func main() {
-	smain.RunServer("mntx_gateway", appversion.Create(), factory)
+	smain.RunServer("gateway", appversion.Create(), factory)
 }

api/pkg/model/payment.go

@@ -1,6 +1,7 @@
 package model
 
 import (
+	"bytes"
 	"encoding/json"
 	"fmt"
 
@@ -71,3 +72,73 @@ type PaymentMethod struct {
 	Data         bson.Raw           `bson:"data" json:"data"`
 	IsMain       bool               `bson:"isMain" json:"isMain"`
 }
+
+type paymentMethodJSON struct {
+	PermissionBound `json:",inline"`
+	Describable     `json:",inline"`
+
+	RecipientRef primitive.ObjectID `json:"recipientRef"`
+	Type         PaymentType        `json:"type"`
+	Data         json.RawMessage    `json:"data"`
+	IsMain       bool               `json:"isMain"`
+}
+
+func (m PaymentMethod) MarshalJSON() ([]byte, error) {
+	var marshaledData json.RawMessage
+
+	if len(m.Data) > 0 {
+		var data bson.M
+		if err := bson.Unmarshal(m.Data, &data); err != nil {
+			return nil, err
+		}
+		if data != nil {
+			b, err := json.Marshal(data)
+			if err != nil {
+				return nil, err
+			}
+			marshaledData = b
+		}
+	}
+
+	payload := paymentMethodJSON{
+		PermissionBound: m.PermissionBound,
+		Describable:     m.Describable,
+		RecipientRef:    m.RecipientRef,
+		Type:            m.Type,
+		Data:            marshaledData,
+		IsMain:          m.IsMain,
+	}
+
+	return json.Marshal(payload)
+}
+
+func (m *PaymentMethod) UnmarshalJSON(data []byte) error {
+	var payload paymentMethodJSON
+	if err := json.Unmarshal(data, &payload); err != nil {
+		return err
+	}
+
+	m.PermissionBound = payload.PermissionBound
+	m.Describable = payload.Describable
+	m.RecipientRef = payload.RecipientRef
+	m.Type = payload.Type
+	m.IsMain = payload.IsMain
+
+	if len(payload.Data) == 0 || bytes.Equal(payload.Data, []byte("null")) {
+		m.Data = nil
+		return nil
+	}
+
+	var rawData map[string]any
+	if err := json.Unmarshal(payload.Data, &rawData); err != nil {
+		return err
+	}
+
+	raw, err := bson.Marshal(rawData)
+	if err != nil {
+		return err
+	}
+
+	m.Data = raw
+	return nil
+}

ci/prod/.env.runtime

@@ -66,11 +66,10 @@ MNTX_GATEWAY_DIR=mntx_gateway
 MNTX_GATEWAY_COMPOSE_PROJECT=sendico-mntx-gateway
 MNTX_GATEWAY_SERVICE_NAME=sendico_mntx_gateway
 MNTX_GATEWAY_GRPC_PORT=50075
-MNTX_GATEWAY_METRICS_PORT=9404
+MNTX_GATEWAY_METRICS_PORT=9405
-MNTX_GATEWAY_HTTP_PORT=8080
+MNTX_GATEWAY_HTTP_PORT=8084
 MONETIX_BASE_URL=https://api.txflux.com
 
-
 # FX oracle stack
 FX_ORACLE_DIR=fx_oracle
 FX_ORACLE_COMPOSE_PROJECT=sendico-fx-oracle

ci/prod/compose/frontend.yml

@@ -31,7 +31,7 @@ services:
       - "0.0.0.0:${FRONTEND_HTTP_PORT}:80"
       - "0.0.0.0:${FRONTEND_HTTPS_PORT}:443"
     healthcheck:
-      test: ["CMD-SHELL","curl -sf http://localhost:80/ >/dev/null"]
+      test: ["CMD", "curl", "-f", "http://localhost:2019/config"]
       interval: 30s
       timeout: 10s
       retries: 3

ci/prod/compose/mntx_gateway.dockerfile

@@ -37,6 +37,6 @@ COPY api/gateway/mntx/config.yml /app/config.yml
 COPY api/gateway/mntx/entrypoint.sh /app/entrypoint.sh
 COPY --from=build /out/mntx-gateway /app/mntx-gateway
 RUN chmod +x /app/entrypoint.sh
-EXPOSE 50075 9404 8084
+EXPOSE 50075 9405 8084
 ENTRYPOINT ["/app/entrypoint.sh"]
 CMD ["/app/mntx-gateway","--config.file","/app/config.yml"]

ci/prod/compose/mntx_gateway.yml

@@ -28,10 +28,10 @@ services:
     command: ["--config.file", "/app/config.yml"]
     ports:
       - "0.0.0.0:${MNTX_GATEWAY_GRPC_PORT:-50075}:50075"
-      - "0.0.0.0:${MNTX_GATEWAY_METRICS_PORT:-9404}:9404"
+      - "0.0.0.0:${MNTX_GATEWAY_METRICS_PORT:-9405}:9405"
       - "0.0.0.0:${MNTX_GATEWAY_HTTP_PORT:-8084}:8084"
     healthcheck:
-      test: ["CMD-SHELL","wget -qO- http://localhost:9404/health | grep -q '\"status\":\"ok\"'"]
+      test: ["CMD-SHELL","wget -qO- http://localhost:9405/health | grep -q '\"status\":\"ok\"'"]
       interval: 30s
       timeout: 10s
       retries: 3

frontend/pshared/lib/models/payment/methods/data.dart

@@ -3,4 +3,6 @@ import 'package:pshared/models/payment/type.dart';
 
 abstract class PaymentMethodData {
   PaymentType get type;
-}
+}
+
+typedef MethodMap = Map<PaymentType, PaymentMethodData?>;

frontend/pshared/lib/models/recipient/recipient.dart

@@ -84,14 +84,13 @@ Recipient newRecipient({
   String? description,
   String? avatarUrl,
   bool isArchived = false,
-}) => 
+}) => Recipient(
-  Recipient(
+  storable: newStorable(),
-    storable: newStorable(),
+  permissionBound: newPermissionBound(organizationBound: newOrganizationBound(organizationRef: organizationRef)),
-    permissionBound: newPermissionBound(organizationBound: newOrganizationBound(organizationRef: organizationRef)),
+  describable: newDescribable(name: name, description: description),
-    describable: newDescribable(name: name, description: description),
+  email: email,
-    email: email,
+  status: status,
-    status: status,
+  type: type,
-    type: type,
+  avatarUrl: avatarUrl,
-    avatarUrl: avatarUrl,
+  isArchived: isArchived,
-    isArchived: isArchived,
+);
-  );

frontend/pshared/lib/provider/account.dart

@@ -27,6 +27,7 @@ class AccountProvider extends ChangeNotifier {
   Resource<Account?> get resource => _resource;
   late LocaleProvider _localeProvider;
   PendingLogin? _pendingLogin;
+  Future<void>? _restoreFuture;
 
   Account? get account => _resource.data;
   PendingLogin? get pendingLogin => _pendingLogin;
@@ -34,6 +35,7 @@ class AccountProvider extends ChangeNotifier {
   bool get isLoading => _resource.isLoading;
   Object? get error => _resource.error;
   bool get isReady => (!isLoading) && (account != null);
+  Future<void>? get restoreFuture => _restoreFuture;
 
   Account? currentUser() {
     final acc = account;
@@ -220,4 +222,12 @@ class AccountProvider extends ChangeNotifier {
       rethrow;
     }
   }
+
+  Future<void> restoreIfPossible() {
+    return _restoreFuture ??= () async {
+      final hasAuth = await AuthorizationService.isAuthorizationStored();
+      if (!hasAuth) return;
+      await restore();
+    }();
+  }
 }

frontend/pshared/lib/provider/recipient/pmethods.dart

@@ -1,7 +1,12 @@
 import 'package:collection/collection.dart';
 
 import 'package:pshared/data/mapper/payment/method.dart';
+import 'package:pshared/models/describable.dart';
+import 'package:pshared/models/organization/bound.dart';
+import 'package:pshared/models/payment/methods/data.dart';
 import 'package:pshared/models/payment/methods/type.dart';
+import 'package:pshared/models/permissions/bound.dart';
+import 'package:pshared/models/storable.dart';
 import 'package:pshared/provider/organizations.dart';
 import 'package:pshared/provider/recipient/provider.dart';
 import 'package:pshared/provider/template.dart';
@@ -49,6 +54,22 @@ class PaymentMethodsProvider extends GenericProvider<PaymentMethod> {
     cascade: true,
   );
 
+  Future<PaymentMethod> create({
+    required String reacipientRef,
+    required PaymentMethodData data,
+    required String name,
+  }) => createObject(
+    _organizations.current.id,
+    PaymentMethod(
+      storable: newStorable(),
+      permissionBound: newPermissionBound(
+        organizationBound: newOrganizationBound(organizationRef: _organizations.current.id),
+      ),
+      recipientRef: reacipientRef,
+      data: data,
+      describable: newDescribable(name: name),
+    ).toDTO().toJson(),
+  );
 
   Future<void> makeMain(PaymentMethod method) {
     // TODO: create separate backend method to manage main payment method

frontend/pshared/lib/provider/recipient/provider.dart

@@ -1,7 +1,9 @@
 
+import 'package:pshared/data/mapper/recipient/recipient.dart';
 import 'package:pshared/models/recipient/filter.dart';
 import 'package:pshared/models/recipient/recipient.dart';
 import 'package:pshared/models/recipient/status.dart';
+import 'package:pshared/models/recipient/type.dart';
 import 'package:pshared/provider/organizations.dart';
 import 'package:pshared/provider/template.dart';
 import 'package:pshared/service/recipient/service.dart';
@@ -51,6 +53,20 @@ class RecipientsProvider extends GenericProvider<Recipient> {
     notifyListeners();
   }
 
+  Future<Recipient> create({
+    required String name,
+    required String email,
+  }) async => createObject(
+    _organizations.current.id,
+    newRecipient(
+      organizationRef: _organizations.current.id, 
+      email: email, 
+      name: name, 
+      status: RecipientStatus.ready, 
+      type: RecipientType.internal,
+    ).toDTO().toJson(),
+  );
+
   void updateProviders(OrganizationsProvider organizations) {
     _organizations = organizations;
     if (_organizations.isOrganizationSet) {

frontend/pweb/lib/app/router/payout_routes.dart

@@ -0,0 +1,112 @@
+import 'package:flutter/widgets.dart';
+
+import 'package:go_router/go_router.dart';
+
+import 'package:pweb/widgets/sidebar/destinations.dart';
+
+
+class PayoutRoutes {
+  static const dashboard = 'dashboard';
+  static const sendPayout = payment;
+  static const recipients = 'payout-recipients';
+  static const addRecipient = 'payout-add-recipient';
+  static const payment = 'payout-payment';
+  static const settings = 'payout-settings';
+  static const reports = 'payout-reports';
+  static const methods = 'payout-methods';
+  static const editWallet = 'payout-edit-wallet';
+  static const walletTopUp = 'payout-wallet-top-up';
+
+  static const dashboardPath = '/dashboard';
+  static const recipientsPath = '/dashboard/recipients';
+  static const addRecipientPath = '/dashboard/recipients/add';
+  static const paymentPath = '/dashboard/payment';
+  static const settingsPath = '/dashboard/settings';
+  static const reportsPath = '/dashboard/reports';
+  static const methodsPath = '/dashboard/methods';
+  static const editWalletPath = '/dashboard/methods/edit';
+  static const walletTopUpPath = '/dashboard/wallet/top-up';
+
+  static String nameFor(PayoutDestination destination) {
+    switch (destination) {
+      case PayoutDestination.dashboard:
+        return dashboard;
+      case PayoutDestination.sendPayout:
+        return payment;
+      case PayoutDestination.recipients:
+        return recipients;
+      case PayoutDestination.addrecipient:
+        return addRecipient;
+      case PayoutDestination.payment:
+        return payment;
+      case PayoutDestination.settings:
+        return settings;
+      case PayoutDestination.reports:
+        return reports;
+      case PayoutDestination.methods:
+        return methods;
+      case PayoutDestination.editwallet:
+        return editWallet;
+      case PayoutDestination.walletTopUp:
+        return walletTopUp;
+    }
+  }
+
+  static String pathFor(PayoutDestination destination) {
+    switch (destination) {
+      case PayoutDestination.dashboard:
+        return dashboardPath;
+      case PayoutDestination.sendPayout:
+        return paymentPath;
+      case PayoutDestination.recipients:
+        return recipientsPath;
+      case PayoutDestination.addrecipient:
+        return addRecipientPath;
+      case PayoutDestination.payment:
+        return paymentPath;
+      case PayoutDestination.settings:
+        return settingsPath;
+      case PayoutDestination.reports:
+        return reportsPath;
+      case PayoutDestination.methods:
+        return methodsPath;
+      case PayoutDestination.editwallet:
+        return editWalletPath;
+      case PayoutDestination.walletTopUp:
+        return walletTopUpPath;
+    }
+  }
+
+  static PayoutDestination? destinationFor(String? routeName) {
+    switch (routeName) {
+      case dashboard:
+        return PayoutDestination.dashboard;
+      case sendPayout:
+        return PayoutDestination.payment;
+      case recipients:
+        return PayoutDestination.recipients;
+      case addRecipient:
+        return PayoutDestination.addrecipient;
+      case payment:
+        return PayoutDestination.payment;
+      case settings:
+        return PayoutDestination.settings;
+      case reports:
+        return PayoutDestination.reports;
+      case methods:
+        return PayoutDestination.methods;
+      case editWallet:
+        return PayoutDestination.editwallet;
+      case walletTopUp:
+        return PayoutDestination.walletTopUp;
+      default:
+        return null;
+    }
+  }
+}
+
+extension PayoutNavigation on BuildContext {
+  void goToPayout(PayoutDestination destination) => goNamed(PayoutRoutes.nameFor(destination));
+
+  void pushToPayout(PayoutDestination destination) => pushNamed(PayoutRoutes.nameFor(destination));
+}

frontend/pweb/lib/app/router/payout_shell.dart

@@ -0,0 +1,160 @@
+import 'package:flutter/material.dart';
+
+import 'package:go_router/go_router.dart';
+
+import 'package:provider/provider.dart';
+
+import 'package:pshared/provider/recipient/provider.dart';
+
+import 'package:pweb/app/router/pages.dart';
+import 'package:pweb/app/router/payout_routes.dart';
+import 'package:pweb/pages/address_book/form/page.dart';
+import 'package:pweb/pages/address_book/page/page.dart';
+import 'package:pweb/pages/dashboard/dashboard.dart';
+import 'package:pweb/pages/payment_methods/page.dart';
+import 'package:pweb/pages/payout_page/page.dart';
+import 'package:pweb/pages/payout_page/wallet/edit/page.dart';
+import 'package:pweb/pages/report/page.dart';
+import 'package:pweb/pages/settings/profile/page.dart';
+import 'package:pweb/pages/wallet_top_up/page.dart';
+import 'package:pweb/providers/page_selector.dart';
+import 'package:pweb/widgets/error/snackbar.dart';
+import 'package:pweb/widgets/sidebar/destinations.dart';
+import 'package:pweb/widgets/sidebar/page.dart';
+
+import 'package:pweb/generated/i18n/app_localizations.dart';
+
+
+RouteBase payoutShellRoute() => ShellRoute(
+  builder: (context, state, child) => PageSelector(
+    child: child,
+    routerState: state,
+  ),
+  routes: [
+    GoRoute(
+      name: PayoutRoutes.dashboard,
+      path: routerPage(Pages.dashboard),
+      pageBuilder: (context, _) => NoTransitionPage(
+        child: DashboardPage(
+          onRecipientSelected: (recipient) => context
+              .read<PageSelectorProvider>()
+              .selectRecipient(context, recipient),
+          onGoToPaymentWithoutRecipient: (type) => context
+              .read<PageSelectorProvider>()
+              .startPaymentWithoutRecipient(context, type),
+          onTopUp: (wallet) => context
+              .read<PageSelectorProvider>()
+              .openWalletTopUp(context, wallet),
+        ),
+      ),
+    ),
+    GoRoute(
+      name: PayoutRoutes.recipients,
+      path: PayoutRoutes.recipientsPath,
+      pageBuilder: (context, _) {
+        final loc = AppLocalizations.of(context)!;
+        return NoTransitionPage(
+          child: RecipientAddressBookPage(
+            onRecipientSelected: (recipient) => context
+                .read<PageSelectorProvider>()
+                .selectRecipient(context, recipient, fromList: true),
+            onAddRecipient: () => context
+                .read<PageSelectorProvider>()
+                .goToAddRecipient(context),
+            onEditRecipient: (recipient) => context
+                .read<PageSelectorProvider>()
+                .editRecipient(context, recipient, fromList: true),
+            onDeleteRecipient: (recipient) => executeActionWithNotification(
+              context: context,
+              action: () async =>
+                  context.read<RecipientsProvider>().delete(recipient.id),
+              successMessage: loc.recipientDeletedSuccessfully,
+              errorMessage: loc.errorDeleteRecipient,
+            ),
+          ),
+        );
+      },
+    ),
+    GoRoute(
+      name: PayoutRoutes.addRecipient,
+      path: PayoutRoutes.addRecipientPath,
+      pageBuilder: (context, _) {
+        final selector = context.read<PageSelectorProvider>();
+        final recipient = selector.recipientProvider.currentObject;
+        return NoTransitionPage(
+          child: AdressBookRecipientForm(
+            recipient: recipient,
+            onSaved: (_) => selector.selectPage(
+              context,
+              PayoutDestination.recipients,
+            ),
+          ),
+        );
+      },
+    ),
+    GoRoute(
+      name: PayoutRoutes.payment,
+      path: PayoutRoutes.paymentPath,
+      pageBuilder: (context, _) => NoTransitionPage(
+        child: PaymentPage(
+          onBack: (_) => context
+              .read<PageSelectorProvider>()
+              .goBackFromPayment(context),
+        ),
+      ),
+    ),
+    GoRoute(
+      name: PayoutRoutes.settings,
+      path: PayoutRoutes.settingsPath,
+      pageBuilder: (_, __) => const NoTransitionPage(
+        child: ProfileSettingsPage(),
+      ),
+    ),
+    GoRoute(
+      name: PayoutRoutes.reports,
+      path: PayoutRoutes.reportsPath,
+      pageBuilder: (_, __) => const NoTransitionPage(
+        child: OperationHistoryPage(),
+      ),
+    ),
+    GoRoute(
+      name: PayoutRoutes.methods,
+      path: PayoutRoutes.methodsPath,
+      pageBuilder: (context, _) => NoTransitionPage(
+        child: PaymentConfigPage(
+          onWalletTap: (wallet) => context
+              .read<PageSelectorProvider>()
+              .selectWallet(context, wallet),
+        ),
+      ),
+    ),
+    GoRoute(
+      name: PayoutRoutes.editWallet,
+      path: PayoutRoutes.editWalletPath,
+      pageBuilder: (context, _) {
+        final provider = context.read<PageSelectorProvider>();
+        final wallet = provider.walletsProvider.selectedWallet;
+        final loc = AppLocalizations.of(context)!;
+
+        return NoTransitionPage(
+          child: wallet != null
+              ? WalletEditPage(
+                  onBack: () => provider.goBackFromWalletEdit(context),
+                )
+              : Center(child: Text(loc.noWalletSelected)),
+        );
+      },
+    ),
+    GoRoute(
+      name: PayoutRoutes.walletTopUp,
+      path: PayoutRoutes.walletTopUpPath,
+      pageBuilder: (context, _) => NoTransitionPage(
+        child: WalletTopUpPage(
+          onBack: () => context
+              .read<PageSelectorProvider>()
+              .goBackFromWalletTopUp(context),
+        ),
+      ),
+    ),
+  ],
+);

frontend/pweb/lib/app/router/router.dart

@@ -1,13 +1,14 @@
 import 'package:go_router/go_router.dart';
 
-import 'package:pweb/app/router/pages.dart';
 import 'package:pweb/app/router/page_params.dart';
+import 'package:pweb/app/router/pages.dart';
+import 'package:pweb/app/router/payout_shell.dart';
+import 'package:pweb/app/router/payout_routes.dart';
 import 'package:pweb/pages/2fa/page.dart';
+import 'package:pweb/pages/errors/not_found.dart';
+import 'package:pweb/pages/login/page.dart';
 import 'package:pweb/pages/signup/page.dart';
 import 'package:pweb/pages/verification/page.dart';
-import 'package:pweb/widgets/sidebar/page.dart';
-import 'package:pweb/pages/login/page.dart';
-import 'package:pweb/pages/errors/not_found.dart';
 
 
 GoRouter createRouter() => GoRouter(
@@ -16,40 +17,33 @@ GoRouter createRouter() => GoRouter(
     GoRoute(
       name: Pages.root.name,
       path: routerPage(Pages.root),
-      builder: (_, _) => const LoginPage(),
+      builder: (_, __) => const LoginPage(),
-      routes: [
-        GoRoute(
-          name: Pages.login.name,
-          path: routerPage(Pages.login),
-          builder: (_, _) => const LoginPage(),
-        ),
-        GoRoute(
-          name: Pages.dashboard.name,
-          path: routerPage(Pages.dashboard),
-          builder: (_, _) => const PageSelector(),
-        ),
-        GoRoute(
-          name: Pages.sfactor.name,
-          path: routerPage(Pages.sfactor),
-          builder: (context, _) => TwoFactorCodePage(
-            onVerificationSuccess: () {
-              // trigger organization load
-              context.goNamed(Pages.dashboard.name);
-            },
-          ),
-        ),
-        GoRoute(
-          name: Pages.signup.name,
-          path: routerPage(Pages.signup),
-          builder: (_, _) => const SignUpPage(),
-        ),
-        GoRoute(
-          name: Pages.verify.name,
-          path: '${routerPage(Pages.verify)}${routerAddParam(PageParams.token)}',
-          builder: (_, state) => AccountVerificationPage(token: state.pathParameters[PageParams.token.name]!),
-        ),
-      ],
     ),
+    GoRoute(
+      name: Pages.login.name,
+      path: routerPage(Pages.login),
+      builder: (_, __) => const LoginPage(),
+    ),
+    GoRoute(
+      name: Pages.sfactor.name,
+      path: routerPage(Pages.sfactor),
+      builder: (context, _) => TwoFactorCodePage(
+        onVerificationSuccess: () => context.goNamed(PayoutRoutes.dashboard),
+      ),
+    ),
+    GoRoute(
+      name: Pages.signup.name,
+      path: routerPage(Pages.signup),
+      builder: (_, __) => const SignUpPage(),
+    ),
+    GoRoute(
+      name: Pages.verify.name,
+      path: '${routerPage(Pages.verify)}${routerAddParam(PageParams.token)}',
+      builder: (_, state) => AccountVerificationPage(
+        token: state.pathParameters[PageParams.token.name]!,
+      ),
+    ),
+    payoutShellRoute(),
   ],
-  errorBuilder: (_, _) => const NotFoundPage(),
+  errorBuilder: (_, __) => const NotFoundPage(),
-);
+);

frontend/pweb/lib/data/mappers/wallet_ui.dart

@@ -21,6 +21,10 @@ extension WalletUiMapper on domain.WalletModel {
       currency: currency,
       isHidden: true,
       calculatedAt: balance?.calculatedAt ?? DateTime.now(),
+      depositAddress: depositAddress,
+      network: asset.chain,
+      tokenSymbol: asset.tokenSymbol,
+      contractAddress: asset.contractAddress,
     );
   }
 }

frontend/pweb/lib/l10n/en.arb

@@ -429,6 +429,19 @@
   "companyName": "Name of your company",
   "companynameRequired": "Company name required",
 
+  "errorSaveRecipient": "Failed to save recipient",
+  "@errorSaveRecipient": {
+    "description": "Error message displayed when saving a recipient fails"
+  },
+  "recipientDeletedSuccessfully": "Recipient deleted successfully",
+  "@recipientDeletedSuccessfully": {
+    "description": "Success message displayed when a recipient is deleted"
+  },
+  "errorDeleteRecipient": "Failed to delete recipient",
+  "@errorDeleteRecipient": {
+    "description": "Error message displayed when deleting a recipient fails"
+  },
+
   "errorSignUp": "Error occured while signing up, try again later",
   "companyDescription": "Company Description",
   "companyDescriptionHint": "Describe any of the fields of the Company's business",
@@ -456,6 +469,17 @@
   "walletNameUpdateFailed": "Failed to update wallet name",
   "walletNameSaved": "Wallet name saved",
   "topUpBalance": "Top Up Balance",
+  "walletTopUpTitle": "Add funds to wallet",
+  "walletTopUpDetailsTitle": "Funding details",
+  "walletTopUpDescription": "Send funds to this address to increase your wallet balance.",
+  "walletTopUpAssetLabel": "Asset",
+  "walletTopUpNetworkLabel": "Network",
+  "walletTopUpAddressLabel": "Deposit address",
+  "walletTopUpQrLabel": "QR code for deposit",
+  "walletTopUpHint": "Only send funds on the specified network. Deposits may take a few minutes to confirm.",
+  "walletTopUpUnavailable": "Top-up details are unavailable for this wallet yet.",
+  "copyAddress": "Copy address",
+  "addressCopied": "Address copied",
   "addFunctionality": "Add functionality",
   "walletHistoryEmpty": "No history yet",
   "colType": "Type",

frontend/pweb/lib/l10n/ru.arb

@@ -429,6 +429,19 @@
   "companyName": "Название вашей компании",
   "companynameRequired": "Необходимо указать название компании",
 
+  "errorSaveRecipient": "Не удалось сохранить получателя",
+  "@errorSaveRecipient": {
+    "description": "Сообщение об ошибке при неудачном сохранении получателя"
+  },
+  "recipientDeletedSuccessfully": "Получатель успешно удален",
+  "@recipientDeletedSuccessfully": {
+    "description": "Сообщение об успешном удалении получателя"
+  },
+  "errorDeleteRecipient": "Не удалось удалить получателя",
+  "@errorDeleteRecipient": {
+    "description": "Сообщение об ошибке при неудачном удалении получателя"
+  },
+
   "errorSignUp": "Произошла ошибка при регистрации, попробуйте позже",
   "companyDescription": "Описание компании",
   "companyDescriptionHint": "Опишите любую из сфер деятельности компании",
@@ -457,6 +470,17 @@
   "walletNameUpdateFailed": "Не удалось обновить название кошелька",
   "walletNameSaved": "Название кошелька сохранено",
   "topUpBalance": "Пополнить баланс",
+  "walletTopUpTitle": "Пополнение кошелька",
+  "walletTopUpDetailsTitle": "Данные для пополнения",
+  "walletTopUpDescription": "Отправьте средства на этот адрес, чтобы пополнить баланс кошелька.",
+  "walletTopUpAssetLabel": "Актив",
+  "walletTopUpNetworkLabel": "Сеть",
+  "walletTopUpAddressLabel": "Адрес для пополнения",
+  "walletTopUpQrLabel": "QR-код для пополнения",
+  "walletTopUpHint": "Отправляйте средства только в указанной сети. Подтверждение может занять несколько минут.",
+  "walletTopUpUnavailable": "Данные для пополнения пока недоступны для этого кошелька.",
+  "copyAddress": "Скопировать адрес",
+  "addressCopied": "Адрес скопирован",
   "addFunctionality": "Добавить функциональность",
   "walletHistoryEmpty": "История пуста",
   "colType": "Тип",

frontend/pweb/lib/main.dart

@@ -26,7 +26,6 @@ import 'package:pweb/providers/upload_history.dart';
 import 'package:pweb/providers/wallets.dart';
 import 'package:pweb/providers/wallet_transactions.dart';
 // import 'package:pweb/services/amplitude.dart';
-// import 'package:pweb/services/amplitude.dart';
 import 'package:pweb/services/operations.dart';
 import 'package:pweb/services/payments/history.dart';
 import 'package:pweb/services/wallet_transactions.dart';

frontend/pweb/lib/models/wallet.dart

@@ -9,6 +9,10 @@ class Wallet {
   final Currency currency;
   final bool isHidden;
   final DateTime calculatedAt;
+  final String? depositAddress;
+  final String? network;
+  final String? tokenSymbol;
+  final String? contractAddress;
 
   Wallet({
     required this.id,
@@ -18,6 +22,10 @@ class Wallet {
     required this.currency,
     required this.calculatedAt,
     this.isHidden = true,
+    this.depositAddress,
+    this.network,
+    this.tokenSymbol,
+    this.contractAddress,
   });
 
   Wallet copyWith({
@@ -27,6 +35,10 @@ class Wallet {
     Currency? currency,
     String? walletUserID,
     bool? isHidden,
+    String? depositAddress,
+    String? network,
+    String? tokenSymbol,
+    String? contractAddress,
   }) => Wallet(
     id: id ?? this.id,
     name: name ?? this.name,
@@ -35,5 +47,9 @@ class Wallet {
     walletUserID: walletUserID ?? this.walletUserID,
     isHidden: isHidden ?? this.isHidden,
     calculatedAt: calculatedAt,
+    depositAddress: depositAddress ?? this.depositAddress,
+    network: network ?? this.network,
+    tokenSymbol: tokenSymbol ?? this.tokenSymbol,
+    contractAddress: contractAddress ?? this.contractAddress,
   );
-}
+}

frontend/pweb/lib/pages/address_book/form/method_tile.dart

@@ -1,5 +1,6 @@
 import 'package:flutter/material.dart';
 
+import 'package:pshared/models/payment/methods/data.dart';
 import 'package:pshared/models/payment/type.dart';
 
 import 'package:pweb/pages/payment_methods/form.dart';
@@ -9,8 +10,8 @@ import 'package:pweb/pages/payment_methods/icon.dart';
 class AdressBookPaymentMethodTile extends StatefulWidget {
   final PaymentType type;
   final String title;
-  final Map<PaymentType, Object?> methods;
+  final MethodMap methods;
-  final ValueChanged<Object?> onChanged;
+  final ValueChanged<PaymentMethodData?> onChanged;
 
   final double spacingM;
   final double spacingS;

frontend/pweb/lib/pages/address_book/form/page.dart

@@ -1,16 +1,23 @@
 import 'package:flutter/material.dart';
 
+import 'package:collection/collection.dart';
+
 import 'package:provider/provider.dart';
 
+import 'package:pshared/models/payment/methods/data.dart';
 import 'package:pshared/models/payment/type.dart';
 import 'package:pshared/models/recipient/recipient.dart';
 import 'package:pshared/models/recipient/status.dart';
 import 'package:pshared/models/recipient/type.dart';
 import 'package:pshared/provider/organizations.dart';
 import 'package:pshared/provider/recipient/pmethods.dart';
+import 'package:pshared/provider/recipient/provider.dart';
 
 import 'package:pweb/pages/address_book/form/view.dart';
 // import 'package:pweb/services/amplitude.dart';
+import 'package:pweb/utils/error/snackbar.dart';
+import 'package:pweb/utils/payment/label.dart';
+import 'package:pweb/utils/snackbar.dart';
 
 import 'package:pweb/generated/i18n/app_localizations.dart';
 
@@ -31,7 +38,7 @@ class _AdressBookRecipientFormState extends State<AdressBookRecipientForm> {
   late TextEditingController _emailCtrl;
   RecipientType _type = RecipientType.internal;
   RecipientStatus _status = RecipientStatus.ready;
-  final Map<PaymentType, Object?> _methods = {};
+  final MethodMap _methods = {};
   late PaymentMethodsProvider _methodsProvider;
 
   Future<void> _loadMethods() async {
@@ -63,31 +70,54 @@ class _AdressBookRecipientFormState extends State<AdressBookRecipientForm> {
     _loadMethods();
   }
 
+  Future<Recipient?> _doSave() async {
+    final recipients = context.read<RecipientsProvider>();
+    final methods = PaymentMethodsProvider();
+    final recipient = widget.recipient == null
+      ? await recipients.create(
+          name: _nameCtrl.text,
+          email: _emailCtrl.text,
+        )
+      : widget.recipient!;
+    recipients.setCurrentObject(recipient.id);
+    //TODO : redesign work with recipients / payment methods
+    await methods.loadMethods(context.read<OrganizationsProvider>(), recipient.id);
+    for (final type in _methods.keys) {
+      final data = _methods[type]!;
+      final exising = methods.methods.firstWhereOrNull((m) => m.type == type);
+      if (exising != null) {
+        await methods.updateMethod(exising.copyWith(data: data));
+      } else {
+        await methods.create(
+          reacipientRef: recipient.id,
+          name: getPaymentTypeLabel(context, type),
+          data: data,
+        );
+      }
+    }
+    return recipient;
+  }
+
   //TODO: Change when registration is ready
-  void _save() {
+  Future<void> _save() async {
     if (!_formKey.currentState!.validate() || _methods.isEmpty) {
-      // AmplitudeService.recipientAddCompleted(
+      notifyUser(context, AppLocalizations.of(context)!.errorSaveRecipient);
-      //   _type,
-      //   _status,
-      //   _methods.keys.toSet(),
-      // );
-      ScaffoldMessenger.of(context).showSnackBar(
-        SnackBar(
-          content: Text(AppLocalizations.of(context)!.recipientFormRule),
-        ),
-      );
       return;
     }
 
-    final recipient = newRecipient(
+    // AmplitudeService.recipientAddCompleted(
-      name: _nameCtrl.text,
+    //   _type,
-      email: _emailCtrl.text,
+    //   _status,
-      type: _type,
+    //   _methods.keys.toSet(),
-      status: _status,
+    // );
-      avatarUrl: null,
+    final recipient = await executeActionWithNotification(
-      organizationRef: context.read<OrganizationsProvider>().current.id
+      context: context, 
+      action: _doSave, 
+      errorMessage: AppLocalizations.of(context)!.errorSaveRecipient,
+      successMessage: AppLocalizations.of(context)!.recipientFormRule,
     );
 
+
     widget.onSaved?.call(recipient);
   }
 

frontend/pweb/lib/pages/address_book/form/view.dart

@@ -1,4 +1,5 @@
 import 'package:flutter/material.dart';
+import 'package:pshared/models/payment/methods/data.dart';
 
 import 'package:pshared/models/payment/type.dart';
 import 'package:pshared/models/recipient/status.dart';
@@ -20,10 +21,10 @@ class FormView extends StatelessWidget {
   final TextEditingController emailCtrl;
   final RecipientType type;
   final RecipientStatus status;
-  final Map<PaymentType, Object?> methods;
+  final MethodMap methods;
   final ValueChanged<RecipientType> onTypeChanged;
   final ValueChanged<RecipientStatus> onStatusChanged;
-  final void Function(PaymentType, Object?) onMethodsChanged;
+  final void Function(PaymentType, PaymentMethodData?) onMethodsChanged;
   final VoidCallback onSave;
   final bool isEditing;
   final VoidCallback onBack;

frontend/pweb/lib/pages/address_book/form/widgets/button.dart

@@ -42,10 +42,10 @@ class SaveButton extends StatelessWidget {
               child: Text(
                 text ?? AppLocalizations.of(context)!.saveRecipient,
                 style: textStyle ??
-                    theme.textTheme.labelLarge?.copyWith(
+                  theme.textTheme.labelLarge?.copyWith(
-                      color: theme.colorScheme.onPrimary,
+                    color: theme.colorScheme.onPrimary,
-                      fontWeight: FontWeight.w600,
+                    fontWeight: FontWeight.w600,
-                    ),
+                  ),
               ),
             ),
           ),

frontend/pweb/lib/pages/address_book/page/list.dart

@@ -1,6 +1,11 @@
 import 'package:flutter/material.dart';
 
+import 'package:provider/provider.dart';
+
+import 'package:pshared/models/permissions/action.dart' as perm;
 import 'package:pshared/models/recipient/recipient.dart';
+import 'package:pshared/models/resources.dart';
+import 'package:pshared/provider/permissions.dart';
 
 import 'package:pweb/pages/address_book/page/recipient/item.dart';
 
@@ -19,9 +24,16 @@ class RecipientAddressBookList extends StatelessWidget {
     this.onDelete,
   });
 
+  bool _checkPermissions(BuildContext context, Recipient recipient, perm.Action action) {
+    return context.read<PermissionsProvider>().canAccessResource(
+      ResourceType.recipients,
+      action: action,
+      objectRef: recipient.id,
+    );
+  }
+
   @override
-Widget build(BuildContext context) {
+  Widget build(BuildContext context) => ListView.builder(
-  return ListView.builder(
     itemCount: filteredRecipients.length,
     itemBuilder: (context, index) {
       final recipient = filteredRecipients[index];
@@ -30,11 +42,14 @@ Widget build(BuildContext context) {
         child: RecipientAddressBookItem(
           recipient: recipient,
           onTap: () => onSelected?.call(recipient),
-          onEdit: () => onEdit?.call(recipient),
+          onEdit: _checkPermissions(context, recipient, perm.Action.update)
-          onDelete: () => onDelete?.call(recipient),
+            ? () => onEdit?.call(recipient)
+            : null,
+          onDelete: _checkPermissions(context, recipient, perm.Action.delete)
+            ? () => onDelete?.call(recipient)
+            : null,
         ),
       );
     },
   );
 }
-}

frontend/pweb/lib/pages/address_book/page/page.dart

@@ -18,12 +18,14 @@ class RecipientAddressBookPage extends StatefulWidget {
   final ValueChanged<Recipient> onRecipientSelected;
   final VoidCallback onAddRecipient;
   final ValueChanged<Recipient>? onEditRecipient;
+  final ValueChanged<Recipient>? onDeleteRecipient;
 
   const RecipientAddressBookPage({
     super.key,
     required this.onRecipientSelected,
     required this.onAddRecipient,
     this.onEditRecipient,
+    this.onDeleteRecipient,
   });
 
   static const double _expandedHeight = 550;
@@ -125,6 +127,7 @@ class _RecipientAddressBookPageState extends State<RecipientAddressBookPage> {
             child: RecipientAddressBookList(
               filteredRecipients: provider.filteredRecipients,
               onEdit: (recipient) => widget.onEditRecipient?.call(recipient),
+              onDelete: (recipient) => widget.onDeleteRecipient?.call(recipient),
               onSelected: widget.onRecipientSelected,
             ),
           ),

frontend/pweb/lib/pages/address_book/page/recipient/actions.dart

@@ -2,18 +2,22 @@ import 'package:flutter/material.dart';
 
 
 class RecipientActions extends StatelessWidget {
-  final VoidCallback onEdit;
+  final VoidCallback? onEdit;
-  final VoidCallback onDelete;
+  final VoidCallback? onDelete;
 
   const RecipientActions({super.key, required this.onEdit, required this.onDelete});
 
   @override
-  Widget build(BuildContext context) {
+  Widget build(BuildContext context) => Row(
-    return Row(
+    children: [
-      children: [
+      IconButton(
-        IconButton(icon: Icon(Icons.edit, color: Theme.of(context).colorScheme.primary), onPressed: onEdit),
+        icon: Icon(Icons.edit, color: Theme.of(context).colorScheme.primary),
-        IconButton(icon: Icon(Icons.delete, color: Theme.of(context).colorScheme.error), onPressed: onDelete),
+        onPressed: onEdit,
-      ],
+      ),
-    );
+      IconButton(
-  }
+        icon: Icon(Icons.delete, color: Theme.of(context).colorScheme.error),
+        onPressed: onDelete,
+      ),
+    ],
+  );
 }

frontend/pweb/lib/pages/address_book/page/recipient/item.dart

@@ -12,8 +12,8 @@ import 'package:pweb/pages/dashboard/payouts/single/adress_book/avatar.dart';
 class RecipientAddressBookItem extends StatefulWidget {
   final Recipient recipient;
   final VoidCallback onTap;
-  final VoidCallback onEdit;
+  final VoidCallback? onEdit;
-  final VoidCallback onDelete;
+  final VoidCallback? onDelete;
 
   final double borderRadius;
   final double elevation;
@@ -82,7 +82,9 @@ class _RecipientAddressBookItemState extends State<RecipientAddressBookItem> {
                     ),
                     if (_isHovered)
                       RecipientActions(
-                          onEdit: widget.onEdit, onDelete: widget.onDelete),
+                        onEdit: widget.onEdit, 
+                        onDelete: widget.onDelete,
+                      ),
                   ],
                 ),
                 SizedBox(height: widget.spacingBottom),

frontend/pweb/lib/pages/dashboard/buttons/balance/balance.dart

@@ -2,6 +2,7 @@ import 'package:flutter/material.dart';
 
 import 'package:provider/provider.dart';
 
+import 'package:pweb/models/wallet.dart';
 import 'package:pweb/pages/dashboard/buttons/balance/carousel.dart';
 import 'package:pweb/providers/wallets.dart';
 
@@ -9,7 +10,9 @@ import 'package:pweb/generated/i18n/app_localizations.dart';
 
 
 class BalanceWidget extends StatelessWidget {
-  const BalanceWidget({super.key});
+  final ValueChanged<Wallet> onTopUp;
+
+  const BalanceWidget({super.key, required this.onTopUp});
 
   @override
   Widget build(BuildContext context) {
@@ -30,6 +33,7 @@ class BalanceWidget extends StatelessWidget {
       WalletCarousel(
         wallets: wallets,
         onWalletChanged: walletsProvider.selectWallet,
+        onTopUp: onTopUp,
       );
   }
 }

frontend/pweb/lib/pages/dashboard/buttons/balance/card.dart

@@ -12,10 +12,12 @@ import 'package:pweb/providers/wallets.dart';
 
 class WalletCard extends StatelessWidget {
   final Wallet wallet;
+  final VoidCallback onTopUp;
 
   const WalletCard({
     super.key,
     required this.wallet,
+    required this.onTopUp,
   });
 
   @override
@@ -43,7 +45,7 @@ class WalletCard extends StatelessWidget {
             ),
             BalanceAddFunds(
               onTopUp: () {
-                // TODO: Implement top-up functionality
+                onTopUp();
               },
             ),
           ],
@@ -51,4 +53,4 @@ class WalletCard extends StatelessWidget {
       ),
     );
   }
-}
+}

frontend/pweb/lib/pages/dashboard/buttons/balance/carousel.dart

@@ -12,11 +12,13 @@ import 'package:pweb/providers/carousel.dart';
 class WalletCarousel extends StatefulWidget {
   final List<Wallet> wallets;
   final ValueChanged<Wallet> onWalletChanged;
+  final ValueChanged<Wallet> onTopUp;
 
   const WalletCarousel({
     super.key,
     required this.wallets,
     required this.onWalletChanged,
+    required this.onTopUp,
   });
 
   @override
@@ -33,6 +35,11 @@ class _WalletCarouselState extends State<WalletCarousel> {
     _pageController = PageController(
       viewportFraction: WalletCardConfig.viewportFraction,
     );
+    WidgetsBinding.instance.addPostFrameCallback((_) {
+      if (widget.wallets.isNotEmpty) {
+        widget.onWalletChanged(widget.wallets[_currentPage]);
+      }
+    });
   }
 
   @override
@@ -83,7 +90,10 @@ class _WalletCarouselState extends State<WalletCarousel> {
             itemBuilder: (context, index) {
               return Padding(
                 padding: WalletCardConfig.cardPadding,
-                child: WalletCard(wallet: widget.wallets[index]),
+                child: WalletCard(
+                  wallet: widget.wallets[index],
+                  onTopUp: () => widget.onTopUp(widget.wallets[index]),
+                ),
               );
             },
           ),
@@ -110,4 +120,4 @@ class _WalletCarouselState extends State<WalletCarousel> {
       ],
     );
   }
-}
+}

frontend/pweb/lib/pages/dashboard/dashboard.dart

@@ -3,6 +3,7 @@ import 'package:flutter/material.dart';
 import 'package:pshared/models/payment/type.dart';
 import 'package:pshared/models/recipient/recipient.dart';
 
+import 'package:pweb/models/wallet.dart';
 import 'package:pweb/pages/dashboard/buttons/balance/balance.dart';
 import 'package:pweb/pages/dashboard/buttons/buttons.dart';
 import 'package:pweb/pages/dashboard/payouts/multiple/title.dart';
@@ -22,11 +23,13 @@ class AppSpacing {
 class DashboardPage extends StatefulWidget {
   final ValueChanged<Recipient> onRecipientSelected;
   final void Function(PaymentType type) onGoToPaymentWithoutRecipient;
+  final ValueChanged<Wallet> onTopUp;
 
   const DashboardPage({
     super.key,
     required this.onRecipientSelected,
     required this.onGoToPaymentWithoutRecipient,
+    required this.onTopUp,
   });
 
   @override
@@ -75,7 +78,9 @@ class _DashboardPageState extends State<DashboardPage> {
               ],
             ),
             const SizedBox(height: AppSpacing.medium),
-            BalanceWidget(),
+            BalanceWidget(
+              onTopUp: widget.onTopUp,
+            ),
             const SizedBox(height: AppSpacing.small),
             if (_showContainerMultiple) TitleMultiplePayout(),
             const SizedBox(height: AppSpacing.medium),

frontend/pweb/lib/pages/dashboard/payouts/single/form/details.dart

@@ -1,5 +1,6 @@
 import 'package:flutter/material.dart';
 
+import 'package:pshared/models/payment/methods/data.dart';
 import 'package:pshared/models/payment/type.dart';
 
 import 'package:pweb/pages/payment_methods/form.dart';
@@ -12,7 +13,7 @@ class PaymentDetailsSection extends StatelessWidget {
   final bool isEditable;
   final VoidCallback? onToggle;
   final PaymentType? selectedType;
-  final Object? data;
+  final PaymentMethodData? data;
 
   const PaymentDetailsSection({
     super.key,
@@ -50,9 +51,7 @@ class PaymentDetailsSection extends StatelessWidget {
         const SizedBox(height: toggleSpacing),
         AnimatedCrossFade(
           duration: animationDuration,
-          crossFadeState: isFormVisible
+          crossFadeState: isFormVisible ? CrossFadeState.showFirst : CrossFadeState.showSecond,
-              ? CrossFadeState.showFirst
-              : CrossFadeState.showSecond,
           firstChild: PaymentMethodForm(
             key: const ValueKey('formVisible'),
             isEditable: isEditable,

frontend/pweb/lib/pages/loaders/account.dart

@@ -17,15 +17,34 @@ class AccountLoader extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) => Consumer<AccountProvider>(builder: (context, provider, _) {
-    if (provider.isLoading) return const Center(child: CircularProgressIndicator());
+    if (provider.account != null) {
-    if (provider.error != null) {
+      WidgetsBinding.instance.addPostFrameCallback((_) {
-      postNotifyUserOfErrorX(
+      });
-        context: context, 
+      return child;
-        errorSituation: AppLocalizations.of(context)!.errorLogin, 
-        exception: provider.error!,
-      );
-      navigateAndReplace(context, Pages.login);
     }
+
+    if (provider.error != null) {
+      WidgetsBinding.instance.addPostFrameCallback((_) {
+        postNotifyUserOfErrorX(
+          context: context, 
+          errorSituation: AppLocalizations.of(context)!.errorLogin, 
+          exception: provider.error!,
+        );
+        navigateAndReplace(context, Pages.login);
+      });
+      return const Center(child: CircularProgressIndicator());
+    }
+
+    if (provider.restoreFuture == null) {
+      WidgetsBinding.instance.addPostFrameCallback((_) {
+        provider.restoreIfPossible().catchError((error, stack) {
+          debugPrint('Account restore failed: $error');
+        });
+      });
+      return const Center(child: CircularProgressIndicator());
+    }
+
+    if (provider.isLoading) return const Center(child: CircularProgressIndicator());
     if (provider.account == null) {
       WidgetsBinding.instance.addPostFrameCallback((_) => navigateAndReplace(context, Pages.login));
       return const Center(child: CircularProgressIndicator());

frontend/pweb/lib/pages/payment_methods/form.dart

@@ -2,6 +2,7 @@ import 'package:flutter/material.dart';
 
 import 'package:pshared/models/payment/methods/card.dart';
 import 'package:pshared/models/payment/methods/crypto_address.dart';
+import 'package:pshared/models/payment/methods/data.dart';
 import 'package:pshared/models/payment/methods/iban.dart';
 import 'package:pshared/models/payment/methods/russian_bank.dart';
 import 'package:pshared/models/payment/methods/wallet.dart';
@@ -16,8 +17,8 @@ import 'package:pweb/pages/payment_methods/add/wallet.dart';
 
 class PaymentMethodForm extends StatelessWidget {
   final PaymentType? selectedType;
-  final ValueChanged<Object?> onChanged;
+  final ValueChanged<PaymentMethodData?> onChanged;
-  final Object? initialData;
+  final PaymentMethodData? initialData;
   final bool isEditable;
 
   const PaymentMethodForm({

frontend/pweb/lib/pages/payment_methods/page.dart

@@ -62,7 +62,7 @@ class _PaymentPageState extends State<PaymentPage> {
     final recipientProvider = context.read<RecipientsProvider>();
 
     recipientProvider.setCurrentObject(recipient.id);
-    pageSelector.selectRecipient(recipient);
+    pageSelector.selectRecipient(context, recipient);
     _flowProvider.reset(pageSelector);
     _clearSearchField();
   }
@@ -72,7 +72,7 @@ class _PaymentPageState extends State<PaymentPage> {
     final recipientProvider = context.read<RecipientsProvider>();
 
     recipientProvider.setCurrentObject(null);
-    pageSelector.selectRecipient(null);
+    pageSelector.selectRecipient(context, null);
     _flowProvider.reset(pageSelector);
     _clearSearchField();
   }

frontend/pweb/lib/pages/payment_methods/widgets/payment_info_section.dart

@@ -1,5 +1,6 @@
 import 'package:flutter/material.dart';
 
+import 'package:pshared/models/payment/methods/data.dart';
 import 'package:pshared/models/payment/type.dart';
 import 'package:pshared/models/recipient/recipient.dart';
 
@@ -31,9 +32,9 @@ class PaymentInfoSection extends StatelessWidget {
   Widget build(BuildContext context) {
     final loc = AppLocalizations.of(context)!;
     final hasRecipient = recipient != null;
-    final availableTypes = hasRecipient
+    final MethodMap availableTypes = hasRecipient
         ? pageSelector.getAvailablePaymentTypes()
-        : {for (final type in PaymentType.values) type: type};
+        : {for (final type in PaymentType.values) type: null};
 
     if (hasRecipient && availableTypes.isEmpty) {
       return Text(loc.recipientNoPaymentDetails);

frontend/pweb/lib/pages/payment_methods/widgets/payment_page_body.dart

@@ -141,7 +141,7 @@ class PaymentBackButton extends StatelessWidget {
           if (onBack != null) {
             onBack!(pageSelector.selectedRecipient);
           } else {
-            pageSelector.goBackFromPayment();
+            pageSelector.goBackFromPayment(context);
           }
         },
       ),

frontend/pweb/lib/pages/payout_page/wallet/edit/buttons/send.dart

@@ -25,7 +25,7 @@ class SendPayoutButton extends StatelessWidget {
         final wallet = walletsProvider.selectedWallet;
         
         if (wallet != null) {
-          pageSelectorProvider.startPaymentFromWallet(wallet);
+          pageSelectorProvider.startPaymentFromWallet(context, wallet);
         }
       },
       child: Text(loc.payoutNavSendPayout),

frontend/pweb/lib/pages/payout_page/wallet/edit/buttons/top_up.dart

@@ -1,5 +1,9 @@
 import 'package:flutter/material.dart';
 
+import 'package:provider/provider.dart';
+
+import 'package:pweb/providers/page_selector.dart';
+import 'package:pweb/providers/wallets.dart';
 import 'package:pweb/generated/i18n/app_localizations.dart';
 
 
@@ -15,9 +19,14 @@ class TopUpButton extends StatelessWidget{
         elevation: 0,
       ),
       onPressed: () {
-        ScaffoldMessenger.of(context).showSnackBar(
+        final wallet = context.read<WalletsProvider>().selectedWallet;
-        SnackBar(content: Text(loc.addFunctionality)),
+        if (wallet == null) {
-        );
+          ScaffoldMessenger.of(context).showSnackBar(
+            SnackBar(content: Text(loc.noWalletSelected)),
+          );
+          return;
+        }
+        context.read<PageSelectorProvider>().openWalletTopUp(context, wallet);
       },
       child: Text(loc.topUpBalance),
     );

frontend/pweb/lib/pages/wallet_top_up/address_block.dart

@@ -0,0 +1,96 @@
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+
+import 'package:qr_flutter/qr_flutter.dart';
+
+import 'package:pweb/utils/dimensions.dart';
+
+import 'package:pweb/generated/i18n/app_localizations.dart';
+
+
+class WalletTopUpAddressBlock extends StatelessWidget {
+  final String address;
+  final AppDimensions dimensions;
+
+  const WalletTopUpAddressBlock({
+    super.key,
+    required this.address,
+    required this.dimensions,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final loc = AppLocalizations.of(context)!;
+
+    return Column(
+      crossAxisAlignment: CrossAxisAlignment.start,
+      children: [
+        Row(
+          mainAxisAlignment: MainAxisAlignment.spaceBetween,
+          children: [
+            Text(
+              loc.walletTopUpAddressLabel,
+              style: theme.textTheme.titleSmall,
+            ),
+            TextButton.icon(
+              icon: const Icon(Icons.copy, size: 16),
+              label: Text(loc.copyAddress),
+              onPressed: () {
+                Clipboard.setData(ClipboardData(text: address));
+                ScaffoldMessenger.of(context).showSnackBar(
+                  SnackBar(content: Text(loc.addressCopied)),
+                );
+              },
+            ),
+          ],
+        ),
+        const SizedBox(height: 6),
+        Container(
+          width: double.infinity,
+          padding: EdgeInsets.all(dimensions.paddingMedium),
+          decoration: BoxDecoration(
+            borderRadius: BorderRadius.circular(dimensions.borderRadiusSmall),
+            border: Border.all(color: theme.colorScheme.outlineVariant),
+            color: theme.colorScheme.surfaceVariant.withOpacity(0.4),
+          ),
+          child: SelectableText(
+            address,
+            style: theme.textTheme.bodyLarge?.copyWith(
+              fontFeatures: const [FontFeature.tabularFigures()],
+            ),
+          ),
+        ),
+        SizedBox(height: dimensions.paddingLarge),
+        Text(
+          loc.walletTopUpQrLabel,
+          style: theme.textTheme.titleSmall,
+        ),
+        const SizedBox(height: 8),
+        Container(
+          padding: EdgeInsets.all(dimensions.paddingMedium),
+          decoration: BoxDecoration(
+            borderRadius: BorderRadius.circular(dimensions.borderRadiusSmall),
+            border: Border.all(color: theme.colorScheme.outlineVariant),
+            color: theme.colorScheme.surfaceVariant.withOpacity(0.4),
+          ),
+          child: Center(
+            child: QrImageView(
+              data: address,
+              backgroundColor: theme.colorScheme.onSecondary,
+              eyeStyle: QrEyeStyle(
+                eyeShape: QrEyeShape.square,
+                color: theme.colorScheme.onSurface,
+              ),
+              dataModuleStyle: QrDataModuleStyle(
+                dataModuleShape: QrDataModuleShape.square,
+                color: theme.colorScheme.onSurface,
+              ),
+              size: 220,
+            ),
+          ),
+        ),
+      ],
+    );
+  }
+}

frontend/pweb/lib/pages/wallet_top_up/content.dart

@@ -0,0 +1,76 @@
+import 'package:flutter/material.dart';
+
+import 'package:pweb/models/wallet.dart';
+import 'package:pweb/pages/wallet_top_up/details.dart';
+import 'package:pweb/pages/wallet_top_up/header.dart';
+import 'package:pweb/pages/wallet_top_up/meta.dart';
+import 'package:pweb/utils/currency.dart';
+import 'package:pweb/utils/dimensions.dart';
+
+
+class WalletTopUpContent extends StatelessWidget {
+  final Wallet wallet;
+  final VoidCallback onBack;
+
+  const WalletTopUpContent({
+    super.key,
+    required this.wallet,
+    required this.onBack,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    final dimensions = AppDimensions();
+    final theme = Theme.of(context);
+
+    final address = _resolveAddress(wallet);
+    final network = wallet.network?.trim();
+    final assetLabel = wallet.tokenSymbol ?? currencyCodeToSymbol(wallet.currency);
+
+    return Align(
+      alignment: Alignment.topCenter,
+      child: SingleChildScrollView(
+        child: ConstrainedBox(
+          constraints: const BoxConstraints(maxWidth: 960),
+          child: Padding(
+            padding: EdgeInsets.symmetric(vertical: dimensions.paddingLarge),
+            child: Material(
+              elevation: dimensions.elevationSmall,
+              color: theme.colorScheme.onSecondary,
+              borderRadius: BorderRadius.circular(dimensions.borderRadiusMedium),
+              child: Padding(
+                padding: EdgeInsets.all(dimensions.paddingXLarge),
+                child: Column(
+                  crossAxisAlignment: CrossAxisAlignment.start,
+                  children: [
+                    WalletTopUpHeader(
+                      onBack: onBack,
+                      walletName: wallet.name,
+                    ),
+                    SizedBox(height: dimensions.paddingLarge),
+                    WalletTopUpMeta(
+                      assetLabel: assetLabel,
+                      network: network,
+                      walletId: wallet.walletUserID,
+                    ),
+                    SizedBox(height: dimensions.paddingXLarge),
+                    WalletTopUpDetails(
+                      address: address,
+                      dimensions: dimensions,
+                    ),
+                  ],
+                ),
+              ),
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+
+  String? _resolveAddress(Wallet wallet) {
+    final candidate = wallet.depositAddress?.trim();
+    if (candidate == null || candidate.isEmpty) return null;
+    return candidate;
+  }
+}

frontend/pweb/lib/pages/wallet_top_up/details.dart

@@ -0,0 +1,60 @@
+import 'package:flutter/material.dart';
+
+import 'package:pweb/pages/wallet_top_up/address_block.dart';
+import 'package:pweb/utils/dimensions.dart';
+
+import 'package:pweb/generated/i18n/app_localizations.dart';
+
+
+class WalletTopUpDetails extends StatelessWidget {
+  final String? address;
+  final AppDimensions dimensions;
+
+  const WalletTopUpDetails({
+    super.key,
+    required this.address,
+    required this.dimensions,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final loc = AppLocalizations.of(context)!;
+
+    return Column(
+      crossAxisAlignment: CrossAxisAlignment.start,
+      children: [
+        Text(
+          loc.walletTopUpDetailsTitle,
+          style: theme.textTheme.titleMedium,
+        ),
+        const SizedBox(height: 6),
+        Text(
+          loc.walletTopUpDescription,
+          style: theme.textTheme.bodyMedium?.copyWith(
+            color: theme.colorScheme.onSurfaceVariant,
+          ),
+        ),
+        SizedBox(height: dimensions.paddingLarge),
+        if (address == null || address!.isEmpty)
+          Text(
+            loc.walletTopUpUnavailable,
+            style: theme.textTheme.bodyMedium,
+          )
+        else ...[
+          WalletTopUpAddressBlock(
+            address: address!,
+            dimensions: dimensions,
+          ),
+          SizedBox(height: dimensions.paddingLarge),
+          Text(
+            loc.walletTopUpHint,
+            style: theme.textTheme.bodySmall?.copyWith(
+              color: theme.colorScheme.onSurfaceVariant,
+            ),
+          ),
+        ],
+      ],
+    );
+  }
+}

frontend/pweb/lib/pages/wallet_top_up/header.dart

@@ -0,0 +1,47 @@
+import 'package:flutter/material.dart';
+
+import 'package:pweb/generated/i18n/app_localizations.dart';
+
+
+class WalletTopUpHeader extends StatelessWidget {
+  final VoidCallback onBack;
+  final String walletName;
+
+  const WalletTopUpHeader({
+    super.key,
+    required this.onBack,
+    required this.walletName,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final loc = AppLocalizations.of(context)!;
+
+    return Row(
+      children: [
+        IconButton(
+          icon: const Icon(Icons.arrow_back),
+          onPressed: onBack,
+        ),
+        const SizedBox(width: 8),
+        Column(
+          crossAxisAlignment: CrossAxisAlignment.start,
+          children: [
+            Text(
+              loc.walletTopUpTitle,
+              style: theme.textTheme.titleLarge,
+            ),
+            const SizedBox(height: 4),
+            Text(
+              walletName,
+              style: theme.textTheme.bodyMedium?.copyWith(
+                color: theme.colorScheme.onSurfaceVariant,
+              ),
+            ),
+          ],
+        ),
+      ],
+    );
+  }
+}

frontend/pweb/lib/pages/wallet_top_up/info_chip.dart

@@ -0,0 +1,48 @@
+import 'package:flutter/material.dart';
+
+import 'package:pweb/utils/dimensions.dart';
+
+
+class WalletTopUpInfoChip extends StatelessWidget {
+  final String label;
+  final String value;
+
+  const WalletTopUpInfoChip({
+    super.key,
+    required this.label,
+    required this.value,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final dimensions = AppDimensions();
+
+    return Container(
+      padding: EdgeInsets.all(dimensions.paddingMedium),
+      decoration: BoxDecoration(
+        borderRadius: BorderRadius.circular(dimensions.borderRadiusSmall),
+        border: Border.all(color: theme.colorScheme.outlineVariant),
+        color: theme.colorScheme.surfaceVariant.withOpacity(0.4),
+      ),
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          Text(
+            label,
+            style: theme.textTheme.labelMedium?.copyWith(
+              color: theme.colorScheme.onSurfaceVariant,
+            ),
+          ),
+          const SizedBox(height: 4),
+          Text(
+            value,
+            style: theme.textTheme.titleMedium?.copyWith(
+              fontWeight: FontWeight.w600,
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+}

frontend/pweb/lib/pages/wallet_top_up/meta.dart

@@ -0,0 +1,37 @@
+import 'package:flutter/material.dart';
+
+import 'package:pweb/pages/wallet_top_up/info_chip.dart';
+import 'package:pweb/utils/dimensions.dart';
+
+import 'package:pweb/generated/i18n/app_localizations.dart';
+
+
+class WalletTopUpMeta extends StatelessWidget {
+  final String assetLabel;
+  final String walletId;
+  final String? network;
+
+  const WalletTopUpMeta({
+    super.key,
+    required this.assetLabel,
+    required this.walletId,
+    this.network,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    final loc = AppLocalizations.of(context)!;
+    final dimensions = AppDimensions();
+
+    return Wrap(
+      spacing: dimensions.paddingLarge,
+      runSpacing: dimensions.paddingLarge,
+      children: [
+        WalletTopUpInfoChip(label: loc.walletTopUpAssetLabel, value: assetLabel),
+        if (network != null && network!.isNotEmpty)
+          WalletTopUpInfoChip(label: loc.walletTopUpNetworkLabel, value: network!),
+        WalletTopUpInfoChip(label: loc.walletId, value: walletId),
+      ],
+    );
+  }
+}

frontend/pweb/lib/pages/wallet_top_up/page.dart

@@ -0,0 +1,44 @@
+import 'package:flutter/material.dart';
+
+import 'package:provider/provider.dart';
+
+import 'package:pweb/pages/wallet_top_up/content.dart';
+import 'package:pweb/providers/wallets.dart';
+
+import 'package:pweb/generated/i18n/app_localizations.dart';
+
+
+class WalletTopUpPage extends StatelessWidget {
+  final VoidCallback onBack;
+
+  const WalletTopUpPage({super.key, required this.onBack});
+
+  @override
+  Widget build(BuildContext context) {
+    final loc = AppLocalizations.of(context)!;
+
+    return Consumer<WalletsProvider>(
+      builder: (context, provider, child) {
+        if (provider.isLoading) {
+          return const Center(child: CircularProgressIndicator());
+        }
+
+        if (provider.error != null) {
+          return Center(
+            child: Text(loc.notificationError(provider.error.toString())),
+          );
+        }
+
+        final wallet = provider.selectedWallet;
+        if (wallet == null) {
+          return Center(child: Text(loc.noWalletSelected));
+        }
+
+        return WalletTopUpContent(
+          wallet: wallet,
+          onBack: onBack,
+        );
+      },
+    );
+  }
+}

frontend/pweb/lib/providers/page_selector.dart

@@ -1,6 +1,7 @@
 import 'package:flutter/material.dart';
 
 import 'package:collection/collection.dart';
+import 'package:pshared/models/payment/methods/data.dart';
 
 import 'package:pshared/models/payment/methods/type.dart';
 import 'package:pshared/models/payment/type.dart';
@@ -11,6 +12,7 @@ import 'package:pshared/provider/recipient/provider.dart';
 import 'package:pweb/models/wallet.dart';
 import 'package:pweb/providers/wallets.dart';
 //import 'package:pweb/services/amplitude.dart';
+import 'package:pweb/app/router/payout_routes.dart';
 import 'package:pweb/widgets/sidebar/destinations.dart';
 
 
@@ -40,44 +42,93 @@ class PageSelectorProvider extends ChangeNotifier {
     methodsProvider = methodsProv;
   }
 
-  void selectPage(PayoutDestination dest) {
+  void syncDestination(PayoutDestination destination) {
-    _selected = dest;
+    if (_selected == destination) return;
+    _selected = destination;
     notifyListeners();
   }
 
-  void selectRecipient(Recipient? recipient, {bool fromList = false}) {
+  void selectPage(
+    BuildContext context,
+    PayoutDestination dest, {
+    bool replace = true,
+  }) {
+    _selected = dest;
+    notifyListeners();
+    _navigateTo(context, dest, replace: replace);
+  }
+
+  void selectRecipient(
+    BuildContext context,
+    Recipient? recipient, {
+    bool fromList = false,
+  }) {
+    final previousDestination = _selected;
     recipientProvider.setCurrentObject(recipient?.id);
     _cameFromRecipientList = fromList;
     _setPreviousDestination();
     _selected = PayoutDestination.payment;
     notifyListeners();
+    if (previousDestination != PayoutDestination.payment) {
+      _navigateTo(context, PayoutDestination.payment, replace: false);
+    }
   }
 
-  void editRecipient(Recipient? recipient, {bool fromList = false}) {
+  void editRecipient(
+    BuildContext context,
+    Recipient? recipient, {
+    bool fromList = false,
+  }) {
+    final previousDestination = _selected;
     recipientProvider.setCurrentObject(recipient?.id);
     _cameFromRecipientList = fromList;
     _selected = PayoutDestination.addrecipient;
     notifyListeners();
+    if (previousDestination != PayoutDestination.addrecipient) {
+      _navigateTo(context, PayoutDestination.addrecipient, replace: false);
+    }
   }
 
-  void goToAddRecipient() {
+  void goToAddRecipient(BuildContext context) {
     // AmplitudeService.recipientAddStarted();
+    final previousDestination = _selected;
     recipientProvider.setCurrentObject(null);
     _selected = PayoutDestination.addrecipient;
     _cameFromRecipientList = false;
     notifyListeners();
+    if (previousDestination != PayoutDestination.addrecipient) {
+      _navigateTo(context, PayoutDestination.addrecipient, replace: false);
+    }
   }
 
-  void startPaymentWithoutRecipient(PaymentType type) {
+  void startPaymentWithoutRecipient(
+    BuildContext context,
+    PaymentType type,
+  ) {
+    final previousDestination = _selected;
     recipientProvider.setCurrentObject(null);
     _type = type;
     _cameFromRecipientList = false;
     _setPreviousDestination();
     _selected = PayoutDestination.payment;
     notifyListeners();
+    if (previousDestination != PayoutDestination.payment) {
+      _navigateTo(context, PayoutDestination.payment, replace: false);
+    }
   }
 
-  void goBackFromPayment() {
+  void goBackFromPayment(BuildContext context) {
+    if (Navigator.of(context).canPop()) {
+      Navigator.of(context).pop();
+    } else {
+      _navigateTo(
+        context,
+        _previousDestination ??
+            (_cameFromRecipientList
+                ? PayoutDestination.recipients
+                : PayoutDestination.dashboard),
+      );
+    }
     _selected = _previousDestination ??
         (_cameFromRecipientList
             ? PayoutDestination.recipients
@@ -88,22 +139,55 @@ class PageSelectorProvider extends ChangeNotifier {
     notifyListeners();
   }
 
-  void goBackFromWalletEdit() {
+  void goBackFromWalletEdit(BuildContext context) {
-    selectPage(PayoutDestination.methods);
+    selectPage(context, PayoutDestination.methods);
   }
 
-  void selectWallet(Wallet wallet) {
+  void selectWallet(BuildContext context, Wallet wallet) {
+    final previousDestination = _selected;
     walletsProvider.selectWallet(wallet);
     _selected = PayoutDestination.editwallet;
     notifyListeners();
+    if (previousDestination != PayoutDestination.editwallet) {
+      _navigateTo(context, PayoutDestination.editwallet, replace: false);
+    }
   }
 
-  void startPaymentFromWallet(Wallet wallet) {
+  void startPaymentFromWallet(BuildContext context, Wallet wallet) {
+    final previousDestination = _selected;
     _type = PaymentType.wallet;
     _cameFromRecipientList = false;
     _setPreviousDestination();
     _selected = PayoutDestination.payment;
     notifyListeners();
+    if (previousDestination != PayoutDestination.payment) {
+      _navigateTo(context, PayoutDestination.payment, replace: false);
+    }
+  }
+
+  void openWalletTopUp(BuildContext context, Wallet wallet) {
+    final previousDestination = _selected;
+    _setPreviousDestination();
+    walletsProvider.selectWallet(wallet);
+    _selected = PayoutDestination.walletTopUp;
+    notifyListeners();
+    if (previousDestination != PayoutDestination.walletTopUp) {
+      _navigateTo(context, PayoutDestination.walletTopUp, replace: false);
+    }
+  }
+
+  void goBackFromWalletTopUp(BuildContext context) {
+    if (Navigator.of(context).canPop()) {
+      Navigator.of(context).pop();
+    } else {
+      _navigateTo(
+        context,
+        _previousDestination ?? PayoutDestination.dashboard,
+      );
+    }
+    _selected = _previousDestination ?? PayoutDestination.dashboard;
+    _previousDestination = null;
+    notifyListeners();
   }
 
   PaymentMethod? getPaymentMethodForWallet(Wallet wallet) {
@@ -112,12 +196,11 @@ class PageSelectorProvider extends ChangeNotifier {
     }
     
     return methodsProvider.methods.firstWhereOrNull(
-      (method) => method.type == PaymentType.wallet && 
+      (method) => method.type == PaymentType.wallet && (method.description?.contains(wallet.walletUserID) ?? false),
-                  (method.description?.contains(wallet.walletUserID) ?? false),
     );
   }
 
-  Map<PaymentType, Object> getAvailablePaymentTypes() {
+  MethodMap getAvailablePaymentTypes() {
     final recipient = selectedRecipient;
     if ((recipient == null) || !methodsProvider.isReady) return {};
 
@@ -158,11 +241,24 @@ class PageSelectorProvider extends ChangeNotifier {
   }
 
   void _setPreviousDestination() {
-    if (_selected != PayoutDestination.payment) {
+    if (_selected != PayoutDestination.payment &&
+        _selected != PayoutDestination.walletTopUp) {
       _previousDestination = _selected;
     }
   }
 
+  void _navigateTo(
+    BuildContext context,
+    PayoutDestination destination, {
+    bool replace = true,
+  }) {
+    if (replace) {
+      context.goToPayout(destination);
+    } else {
+      context.pushToPayout(destination);
+    }
+  }
+
   Recipient? get selectedRecipient => recipientProvider.currentObject;
   Wallet? get selectedWallet => walletsProvider.selectedWallet;
 }

frontend/pweb/lib/providers/payment_flow_provider.dart

@@ -1,4 +1,5 @@
 import 'package:flutter/foundation.dart';
+import 'package:pshared/models/payment/methods/data.dart';
 
 import 'package:pshared/models/payment/type.dart';
 import 'package:pshared/models/recipient/recipient.dart';
@@ -8,14 +9,14 @@ import 'package:pweb/providers/page_selector.dart';
 
 class PaymentFlowProvider extends ChangeNotifier {
   PaymentType _selectedType;
-  Object? _manualPaymentData;
+  PaymentMethodData? _manualPaymentData;
 
   PaymentFlowProvider({
     required PaymentType initialType,
   }) : _selectedType = initialType;
 
   PaymentType get selectedType => _selectedType;
-  Object? get manualPaymentData => _manualPaymentData;
+  PaymentMethodData? get manualPaymentData => _manualPaymentData;
 
   void syncWithSelector(PageSelectorProvider selector) {
     final recipient = selector.selectedRecipient;
@@ -53,7 +54,7 @@ class PaymentFlowProvider extends ChangeNotifier {
     notifyListeners();
   }
 
-  void setManualPaymentData(Object? data) {
+  void setManualPaymentData(PaymentMethodData? data) {
     _manualPaymentData = data;
     notifyListeners();
   }

frontend/pweb/lib/services/wallets.dart

@@ -1,6 +1,5 @@
 import 'package:pshared/service/wallet.dart' as shared_wallet_service;
 
-import 'package:pweb/models/currency.dart';
 import 'package:pweb/models/wallet.dart';
 import 'package:pweb/data/mappers/wallet_ui.dart';
 
@@ -10,27 +9,6 @@ abstract class WalletsService {
   Future<double> getBalance(String organizationRef, String walletRef);
 }
 
-class MockWalletsService implements WalletsService {
-  final List<Wallet> _wallets = [
-    Wallet(id: '1124', walletUserID: 'WA-12345667', name: 'Main Wallet', balance: 10000000.0, currency: Currency.rub, calculatedAt: DateTime.now()),
-    Wallet(id: '2124', walletUserID: 'WA-76654321', name: 'Savings', balance: 2500.5, currency: Currency.usd, calculatedAt: DateTime.now()),
-  ];
-
-  @override
-  Future<List<Wallet>> getWallets(String _) async {
-    return _wallets;
-  }
-
-  @override
-  Future<double> getBalance(String _, String walletRef) async {
-    final wallet = _wallets.firstWhere(
-      (w) => w.id == walletRef,
-      orElse: () => throw Exception('Wallet not found'),
-    );
-    return wallet.balance;
-  }
-}
-
 class ApiWalletsService implements WalletsService {
   @override
   Future<List<Wallet>> getWallets(String organizationRef) async {

frontend/pweb/lib/utils/error/snackbar.dart

@@ -1,6 +1,7 @@
 import 'dart:async';
 
 import 'package:flutter/material.dart';
+import 'package:pshared/utils/snackbar.dart';
 
 import 'package:pweb/utils/error/handler.dart';
 import 'package:pweb/widgets/error/content.dart';
@@ -52,13 +53,18 @@ Future<T?> executeActionWithNotification<T>({
   required BuildContext context,
   required Future<T> Function() action,
   required String errorMessage,
+  String? successMessage,
   int delaySeconds = 3,
 }) async {
   final scaffoldMessenger = ScaffoldMessenger.of(context);
   final localizations = AppLocalizations.of(context)!;
 
   try {
-    return await action();
+    final result = await action();
+    if (successMessage != null) {
+      notifyUser(context, successMessage, delaySeconds: delaySeconds);
+    }
+    return result;
   } catch (e) {
     // Report the error using your existing notifier.
     notifyUserOfErrorX(

frontend/pweb/lib/utils/payment/selector_type.dart

@@ -1,12 +1,13 @@
 import 'package:flutter/material.dart';
 
+import 'package:pshared/models/payment/methods/data.dart';
 import 'package:pshared/models/payment/type.dart';
 
 import 'package:pweb/utils/payment/label.dart';
 
 
 class PaymentTypeSelector extends StatelessWidget {
-  final Map<PaymentType, Object> availableTypes;
+  final MethodMap availableTypes;
   final PaymentType selectedType;
   final ValueChanged<PaymentType> onSelected;
 

frontend/pweb/lib/widgets/sidebar/destinations.dart

@@ -12,7 +12,8 @@ enum PayoutDestination {
   methods(Icons.credit_card, 'methods'),
   payment(Icons.payment, 'payout'),
   addrecipient(Icons.app_registration, 'add recipient'),
-  editwallet(Icons.wallet, 'edit wallet');
+  editwallet(Icons.wallet, 'edit wallet'),
+  walletTopUp(Icons.qr_code_2_outlined, 'wallet top up');
 
 
   const PayoutDestination(this.icon, this.labelKey);
@@ -41,6 +42,8 @@ enum PayoutDestination {
         return loc.addRecipient;
       case PayoutDestination.editwallet:
         return loc.editWallet;
+      case PayoutDestination.walletTopUp:
+        return loc.walletTopUpTitle;
     }
   }
 }

frontend/pweb/lib/widgets/sidebar/page.dart

@@ -2,114 +2,61 @@ import 'package:flutter/material.dart';
 
 import 'package:provider/provider.dart';
 
+import 'package:go_router/go_router.dart';
+
 import 'package:pshared/models/resources.dart';
 import 'package:pshared/provider/permissions.dart';
 
-import 'package:pweb/pages/address_book/form/page.dart';
-import 'package:pweb/pages/address_book/page/page.dart';
 import 'package:pweb/pages/loader.dart';
-import 'package:pweb/pages/payment_methods/page.dart';
-import 'package:pweb/pages/payout_page/page.dart';
-import 'package:pweb/pages/payout_page/wallet/edit/page.dart';
-import 'package:pweb/pages/report/page.dart';
-import 'package:pweb/pages/settings/profile/page.dart';
-import 'package:pweb/pages/dashboard/dashboard.dart';
 import 'package:pweb/providers/page_selector.dart';
 import 'package:pweb/utils/logout.dart';
 import 'package:pweb/widgets/appbar/app_bar.dart';
 import 'package:pweb/widgets/sidebar/destinations.dart';
 import 'package:pweb/widgets/sidebar/sidebar.dart';
-
+import 'package:pweb/app/router/payout_routes.dart';
-import 'package:pweb/generated/i18n/app_localizations.dart';
 
 
 class PageSelector extends StatelessWidget {
-  const PageSelector({super.key});
+  final Widget child;
+  final GoRouterState routerState;
+
+  const PageSelector({
+    super.key,
+    required this.child,
+    required this.routerState,
+  });
 
   @override
   Widget build(BuildContext context) => PageViewLoader(
     child: Builder(builder: (BuildContext context) {
-      final permissions = context.watch<PermissionsProvider>();
+      final permissions = context.read<PermissionsProvider>();
       if (!permissions.isReady) return Center(child: CircularProgressIndicator());
 
       final provider = context.watch<PageSelectorProvider>();
 
-      final loc = AppLocalizations.of(context)!;
-
       final bool restrictedAccess = !permissions.canRead(ResourceType.chainWallets);
       final allowedDestinations = restrictedAccess
         ? <PayoutDestination>{
             PayoutDestination.settings,
             PayoutDestination.methods,
             PayoutDestination.editwallet,
+            PayoutDestination.walletTopUp,
           }
         : PayoutDestination.values.toSet();
 
-      final selected = allowedDestinations.contains(provider.selected)
+      final routeDestination = _destinationFromState(routerState) ?? provider.selected;
-        ? provider.selected
+      final selected = allowedDestinations.contains(routeDestination)
+        ? routeDestination
         : (restrictedAccess ? PayoutDestination.settings : PayoutDestination.dashboard);
 
-      if (selected != provider.selected) {
+      if (selected != routeDestination) {
-        WidgetsBinding.instance.addPostFrameCallback((_) => provider.selectPage(selected));
+        WidgetsBinding.instance.addPostFrameCallback((_) {
+          context.goToPayout(selected);
+        });
       }
 
-      Widget content;
+      if (provider.selected != selected) {
-      switch (selected) {
+        provider.syncDestination(selected);
-        case PayoutDestination.dashboard:
-          content = DashboardPage(
-            onRecipientSelected: (recipient) => provider.selectRecipient(recipient),
-            onGoToPaymentWithoutRecipient: provider.startPaymentWithoutRecipient,
-          );
-          break;
-
-        case PayoutDestination.recipients:
-          content = RecipientAddressBookPage(
-            onRecipientSelected: (recipient) =>
-              provider.selectRecipient(recipient, fromList: true),
-            onAddRecipient: provider.goToAddRecipient,
-            onEditRecipient: provider.editRecipient,
-          );
-          break;
-
-        case PayoutDestination.addrecipient:
-          final recipient = provider.recipientProvider.currentObject;
-          content = AdressBookRecipientForm(
-            recipient: recipient,
-            onSaved: (_) => provider.selectPage(PayoutDestination.recipients),
-          );
-          break;
-
-        case PayoutDestination.payment:
-          content = PaymentPage(
-            onBack: (_) => provider.goBackFromPayment(),
-          );
-          break;
-
-        case PayoutDestination.settings:
-          content = ProfileSettingsPage();
-          break;
-
-        case PayoutDestination.reports:
-          content = OperationHistoryPage();
-          break;
-
-        case PayoutDestination.methods:
-          content = PaymentConfigPage(
-            onWalletTap: provider.selectWallet,
-          );
-          break;
-
-        case PayoutDestination.editwallet:
-          final wallet = provider.walletsProvider.selectedWallet;
-          content = wallet != null
-              ? WalletEditPage(
-                onBack: provider.goBackFromWalletEdit,
-              )
-              : Center(child: Text(loc.noWalletSelected));
-          break;
-
-        default:
-          content = Text(selected.name);
       }
 
       return Scaffold(
@@ -126,14 +73,49 @@ class PageSelector extends StatelessWidget {
             children: [
               PayoutSidebar(
                 selected: selected,
-                onSelected: provider.selectPage,
+                onSelected: context.goToPayout,
                 onLogout: () => logoutUtil(context),
               ),
-              Expanded(child: content),
+              Expanded(child: child),
             ],
           ),
         ),
       );
     },
   ));
+
+  PayoutDestination? _destinationFromState(GoRouterState state) {
+    final byName = PayoutRoutes.destinationFor(state.name);
+    if (byName != null) return byName;
+
+    final location = state.matchedLocation;
+    if (location.startsWith(PayoutRoutes.editWalletPath)) {
+      return PayoutDestination.editwallet;
+    }
+    if (location.startsWith(PayoutRoutes.walletTopUpPath)) {
+      return PayoutDestination.walletTopUp;
+    }
+    if (location.startsWith(PayoutRoutes.methodsPath)) {
+      return PayoutDestination.methods;
+    }
+    if (location.startsWith(PayoutRoutes.paymentPath)) {
+      return PayoutDestination.payment;
+    }
+    if (location.startsWith(PayoutRoutes.addRecipientPath)) {
+      return PayoutDestination.addrecipient;
+    }
+    if (location.startsWith(PayoutRoutes.recipientsPath)) {
+      return PayoutDestination.recipients;
+    }
+    if (location.startsWith(PayoutRoutes.settingsPath)) {
+      return PayoutDestination.settings;
+    }
+    if (location.startsWith(PayoutRoutes.reportsPath)) {
+      return PayoutDestination.reports;
+    }
+    if (location.startsWith(PayoutRoutes.dashboardPath)) {
+      return PayoutDestination.dashboard;
+    }
+    return null;
+  }
 }

frontend/pweb/pubspec.yaml

@@ -67,6 +67,7 @@ dependencies:
   syncfusion_flutter_charts: ^31.2.10
   flutter_multi_formatter: ^2.13.7
   dotted_border: ^3.1.0
+  qr_flutter: ^4.1.0
 
 
 
@@ -96,7 +97,7 @@ flutter:
 
   # To add assets to your application, add an assets section, like this:
   assets:
-    - resources/logo.png
+    - resources/icon.png
     - resources/logo.si
 
   # An image asset can refer to one or more resolution-specific "variants", see