> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.6mm.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.6mm.com/_mcp/server.

# Actualice a v0.3.0

Esta guía está dirigida a **Agent Java SDK `v0.3.0`** y Java 8+.

## Decida qué necesita actualizarse

| Integración existente                                                      | Acción                                                                                                           |
| -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Funciones de producción existentes con entorno omitido.                    | Las formas de respuesta existentes siguen siendo compatibles; las nuevas consultas no fuerzan una actualización. |
| Autenticación de inserción genérica existente para el comercio de segundos | Reutilizar autenticación y renovación; seleccione la página del producto requerido.                              |
| Saldos de financiación, transferencias y recuperaciones                    | Utilice los modelos que contienen `withFunding`, `walletTransfer` y `queryWalletTransfer`.                       |
| Fondos simulados explícitos                                                | Utilice modelos de solicitud/respuesta que admitan `environment`.                                                |
| Seis consultas de datos permanentes                                        | Utilice Java público SDK `v0.3.0` público, incluidos los seis métodos y el soporte de firma de matrices.         |

Conserve sus `baseUrl`, `agentCode`, `apiSecret` actuales, enlaces de usuario y pedidos comerciales originales.

## Instalar la etiqueta pública estable

Fuente de alojamiento de GitHub. La publicación de una etiqueta de GitHub no publica las coordenadas de Maven en Maven Central. Instale la fuente etiquetada localmente o publique su JAR/POM verificado en el repositorio de artefactos de su organización.

```bash
git clone --branch v0.3.0 --single-branch https://github.com/6mm-com/agent-java-sdk.git agent-java-sdk-v0.3.0
cd agent-java-sdk-v0.3.0
git rev-parse HEAD
git rev-parse 'v0.3.0^{commit}'
mvn install
```

Los dos ID de confirmación deben coincidir. Declare la dependencia en el proyecto asociado:

```xml
<dependency>
    <groupId>com.sixmm.exchange.sdk</groupId>
    <artifactId>agent</artifactId>
    <version>0.3.0</version>
</dependency>
```

Verifique la dependencia resuelta:

```bash
mvn dependency:tree -Dincludes=com.sixmm.exchange.sdk:agent
```

Una instalación local sólo hace que el artefacto esté disponible en esa máquina. CI y otros desarrolladores necesitan la misma instalación etiquetada o su repositorio de artefactos verificado. Si ya tienes un artefacto privado llamado `0.3.0`, verifica su fuente y sus métodos; no sobrescriba silenciosamente un artefacto compartido.

## Cambios de integración requeridos

1. Actualice los modelos de solicitud y respuesta para `environment` explícito. Los modelos de respuesta más antiguos y estrictos pueden rechazar el campo adicional.
2. Utilice `withFunding()` antes de leer `funding`. Los saldos de contrato no son saldos de segunda negociación.
3. Utilice `/v1/agent/wallet-transfer` y `/v1/agent/wallet-transfer-status` para financiación. El antiguo `queryOrder` no puede recuperar una operación de financiación.
4. Las seis consultas utilizan `platformUserIds` como una matriz de cadenas. Firmar matrices como compactas JSON; Java `List.toString()` no es compatible.
5. Almacene órdenes de transferencia, órdenes comerciales ordinarias, órdenes condicionales y ejecuciones como entidades distintas. Analiza `orderStatus` o `status` según la operación.
6. Verifique el cuerpo webhook original antes de analizarlo. Las notificaciones simuladas explícitas incluyen `environment`; compárelo con el pedido guardado.
7. Administre Java y las versiones de widgets de forma independiente. Una actualización de backend no cambia la página de inicio ni el modo de negociación, y las segundas operaciones no requieren un nuevo tipo de token.

## Verificar la actualización

Ejecute la compilación del proyecto asociado e inspeccione su árbol de dependencia. Enlace de prueba, flujo de producción original, saldos simulados explícitos, recuperación de resultados de financiación, las seis consultas, paginación de ventana fija, manejo de errores y devoluciones de llamada idempotentes.

Para un cliente HTTP personalizado, siga la solicitud etiquetada y el contrato de firma en lugar de asumir que los modelos antiguos cubren campos nuevos. Ver [Reglas de firma del agente](/es-419/sdk/security/secrets-signing#signing-rule), [Resumen de consultas](/es-419/sdk/agent-sdk/java/perpetual-queries) y [guía medioambiental](/es-419/sdk/agent-sdk/java/environments).

## Guías fuente y relacionadas

* [Fuente oficial v0.3.0](https://github.com/6mm-com/agent-java-sdk/tree/54aa3c1)
* [Descripción general de consultas y paginación](/es-419/sdk/agent-sdk/java/perpetual-queries)
* [Cartera de financiación](/es-419/sdk/agent-sdk/java/funding-wallet)