;
};
Para Server SDK provides seamless integration with the Stellar blockchain. Once you've set up and authenticated your Para Server client, the Stellar integration works identically to the client-side implementation.
Before using these integrations, ensure you've completed the server setup by importing a client session or creating a pregenerated wallet. See the for details.
## Installation
Install the required dependencies:
```bash npm theme={null}
npm install @getpara/stellar-sdk-v14-integration @stellar/stellar-sdk --save-exact
```
```bash yarn theme={null}
yarn add @getpara/stellar-sdk-v14-integration @stellar/stellar-sdk --exact
```
## Implementation
### Functional API
The `createParaStellarSigner` function returns a signer compatible with Stellar SDK's `contract.SignTransaction` and `contract.SignAuthEntry` interfaces:
```typescript theme={null}
import { Para as ParaServer } from "@getpara/server-sdk";
import { createParaStellarSigner } from "@getpara/stellar-sdk-v14-integration";
import { Horizon, Networks, TransactionBuilder, Operation, Asset, BASE_FEE } from "@stellar/stellar-sdk";
// Para server client (already authenticated)
const paraServer = new ParaServer("YOUR_API_KEY");
// Set up Horizon connection
const server = new Horizon.Server("https://horizon.stellar.org");
// Create the Stellar signer
const signer = createParaStellarSigner({
para: paraServer,
networkPassphrase: Networks.PUBLIC,
});
console.log(`Stellar address: ${signer.address}`);
// Load the source account
const sourceAccount = await server.loadAccount(signer.address);
// Build a payment transaction
const transaction = new TransactionBuilder(sourceAccount, {
fee: BASE_FEE,
networkPassphrase: Networks.PUBLIC,
})
.addOperation(
Operation.payment({
destination: "GRECIPI...",
asset: Asset.native(),
amount: "10",
})
)
.setTimeout(180)
.build();
// Sign and submit
const { signedTxXdr } = await signer.signTransaction(transaction.toXDR());
const signedTx = TransactionBuilder.fromXDR(signedTxXdr, Networks.PUBLIC);
const result = await server.submitTransaction(signedTx);
console.log(`Transaction hash: ${result.hash}`);
```
### Class API
The `ParaStellarSigner` class can also be instantiated directly. Pass `networkPassphrase` to the constructor so `signTransaction` uses it as the default:
```typescript theme={null}
import { Para as ParaServer } from "@getpara/server-sdk";
import { ParaStellarSigner } from "@getpara/stellar-sdk-v14-integration";
import { Horizon, Networks, TransactionBuilder, Operation, Asset, BASE_FEE } from "@stellar/stellar-sdk";
const paraServer = new ParaServer("YOUR_API_KEY");
const server = new Horizon.Server("https://horizon.stellar.org");
// Create the signer
const signer = new ParaStellarSigner(paraServer, Networks.PUBLIC);
console.log(`Stellar address: ${signer.address}`);
// Load account and build transaction
const sourceAccount = await server.loadAccount(signer.address);
const transaction = new TransactionBuilder(sourceAccount, {
fee: BASE_FEE,
networkPassphrase: Networks.PUBLIC,
})
.addOperation(
Operation.payment({
destination: "GRECIPI...",
asset: Asset.native(),
amount: "10",
})
)
.setTimeout(180)
.build();
// Sign and submit
const { signedTxXdr } = await signer.signTransaction(transaction.toXDR());
const signedTx = TransactionBuilder.fromXDR(signedTxXdr, Networks.PUBLIC);
const result = await server.submitTransaction(signedTx);
console.log(`Transaction hash: ${result.hash}`);
```
## Best Practices
* Always load the source account from Horizon before building transactions to get the correct sequence number
* Use `setTimeout()` on transactions to prevent them from being valid indefinitely
* Consider fee bump transactions during network congestion
* Use higher fees during high-traffic periods to ensure transaction inclusion
## Learn More
For detailed examples including multi-operation transactions, fee bumps, and Soroban auth, refer to our web documentation:
