Go Service for Neuron-Perun Payment Integration

[devchenyan]

Service Overview

Objective

Provide a Go-based backend service to facilitate the integration of Perun Payment into Neuron, acting as a bridge between the Channel Service and Wallet Service.

Background

During the integration of Perun Payment into Neuron, support from a Go service is required.

Neuron runs a Channel Service Client and a Wallet Service Server, and requires a corresponding service to operate the matching Channel Service Server and Wallet Service Client.

Based on the existing Neuron example, implement the following API.

Channel Service API

• openChannel(me: Uint8Array, peerToConnectTo: Uint8Array, allocation: Allocation, challengeDuration: number): ServiceResponse<ChannelServiceImplementation["openChannel"]>;

• getChannels(requester: Uint8Array): ServiceResponse<ChannelServiceImplementation["getChannels"]>;

• updateChannel(channelId: Uint8Array, assetIdx: number, amount: bigint): ServiceResponse<ChannelServiceImplementation["updateChannel"]>;

• closeChannel(channelId: Uint8Array): ServiceResponse<ChannelServiceImplementation["closeChannel"]>;

Wallet Service API

• openChannelRequest(req: ValidOpenChannelRequest): ServiceResponse<WalletServiceImplementation["openChannel"]>;

• updateNotificationRequest(req: ServiceRequest<WalletServiceImplementation["updateNotification"]>):
  ServiceResponse<WalletServiceImplementation["updateNotification"]>;

• signMessageRequest(req: ValidSignMessageRequest): ServiceResponse<WalletServiceImplementation["signMessage"]>;

• signTransactionRequest(req: ServiceRequest<WalletServiceImplementation["signTransaction"]>): ServiceResponse<WalletServiceImplementation["signTransaction"]>;

Core Implementation Workflow

• Service Initialization

  • Listens for ChannelServiceClient connection requests.
  • Registers a ChannelServiceServer instance and initializes user context.

• Wallet Service Integration

  • Creates a WalletServiceClient to connect to Neuron’s WalletServiceServer.
  • Forwards signing requests to Neuron and returns responses.

• Channel Lifecycle Management

  • OpenChannel
  • UpdateChannel
  • CloseChannel

• Configuration Management

  • Supports multi-environment (dev/test/prod) deployment:
    • testnet: https://github.com/perun-network/channel-service/tree/dev/test/testnet

Deliverables

• Neuron example: https://github.com/perun-network/neuron/pull/2/files
• Runnable Go service

[Keith-CY]

Background:

When integrating Neuron with Perun, a stable and reliable Go service is required as a foundational component.

Objectives:

1. Develop a Stable & Production-ready Go Service

• listen on host
• create WalletServiceClient、ChannelServiceServer
• Implement interaction with the js-example

2. Implement a js-example using perun-network/perun-wallet-wrapper
3. Full Protocol Flow Implementation

• Complete end-to-end implementation of all processes specified in the Perun Wallet Specification:
  perun-network/perun-wallet-spec@main/resources

Please add more specific reasons behind the stable and reliable in the background. e.g., which function/service is unstable/reliable, and how it's expected to be.

[Danie0918]

https://github.com/perun-network/channel-service-runner